{"action":"created","issue":{"url":"https://api.github.com/repos/tomchristie/django-rest-framework/issues/3065","labels_url":"https://api.github.com/repos/tomchristie/django-rest-framework/issues/3065/labels{/name}","comments_url":"https://api.github.com/repos/tomchristie/django-rest-framework/issues/3065/comments","events_url":"https://api.github.com/repos/tomchristie/django-rest-framework/issues/3065/events","html_url":"https://github.com/tomchristie/django-rest-framework/issues/3065","id":90372088,"number":3065,"title":"Use of ManyToManyField not clearly documented","user":{"login":"nmgeek","id":2481775,"avatar_url":"https://avatars.githubusercontent.com/u/2481775?v=3","gravatar_id":"","url":"https://api.github.com/users/nmgeek","html_url":"https://github.com/nmgeek","followers_url":"https://api.github.com/users/nmgeek/followers","following_url":"https://api.github.com/users/nmgeek/following{/other_user}","gists_url":"https://api.github.com/users/nmgeek/gists{/gist_id}","starred_url":"https://api.github.com/users/nmgeek/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/nmgeek/subscriptions","organizations_url":"https://api.github.com/users/nmgeek/orgs","repos_url":"https://api.github.com/users/nmgeek/repos","events_url":"https://api.github.com/users/nmgeek/events{/privacy}","received_events_url":"https://api.github.com/users/nmgeek/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/tomchristie/django-rest-framework/labels/Documentation","name":"Documentation","color":"444444"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":5,"created_at":"2015-06-23T12:18:52Z","updated_at":"2015-06-23T15:42:30Z","closed_at":null,"body":"I've been wrestling with how to encode my ManyToManyField for a couple days.  One thing that makes it very difficult is the lack of any example in the documentation.  It's also frustrating that all the documentation on relations uses the same, reverse relation example: tracks.  So it's not even clear to me how to code up a forward relation and get the nested lists like the tracks lists.  Could someone add\r\n\r\na) a forward relation example?\r\nb) a ManyToMany example?\r\nc) more clarification to the ManyToMany section about the implications of setting the read_only flag and some hint about whether it is possible to get write behavior on ManyToMany fields with custom classes and some hint about how to go about that?\r\n\r\nNote that I'm about to give up on any nested representation of ManyToMany slugs and use a custom serializer to code up the list as a flat string.  I am also finding little documentation on how to create a custom field class, though."},"comment":{"url":"https://api.github.com/repos/tomchristie/django-rest-framework/issues/comments/114550783","html_url":"https://github.com/tomchristie/django-rest-framework/issues/3065#issuecomment-114550783","issue_url":"https://api.github.com/repos/tomchristie/django-rest-framework/issues/3065","id":114550783,"user":{"login":"xordoquy","id":2340654,"avatar_url":"https://avatars.githubusercontent.com/u/2340654?v=3","gravatar_id":"","url":"https://api.github.com/users/xordoquy","html_url":"https://github.com/xordoquy","followers_url":"https://api.github.com/users/xordoquy/followers","following_url":"https://api.github.com/users/xordoquy/following{/other_user}","gists_url":"https://api.github.com/users/xordoquy/gists{/gist_id}","starred_url":"https://api.github.com/users/xordoquy/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/xordoquy/subscriptions","organizations_url":"https://api.github.com/users/xordoquy/orgs","repos_url":"https://api.github.com/users/xordoquy/repos","events_url":"https://api.github.com/users/xordoquy/events{/privacy}","received_events_url":"https://api.github.com/users/xordoquy/received_events","type":"User","site_admin":false},"created_at":"2015-06-23T15:42:30Z","updated_at":"2015-06-23T15:42:30Z","body":"At his point I'm tempted to close this issue.\r\nWhat @tomchristie mentions is already in the documentation (tutorial's step 1)."}}