Clarifications

[cancan101]

Could you clarify what is meant by "The default ember-data RESTAdapter does not follow the conventions used by the django rest framework"?

Also, I assume that the adapter will not work with nested routers (see for example: https://github.com/alanjds/drf-nested-routers) if the update/delete/get are nested?

What is the reason that you must "have 2 different endpoints per django model"? Won't the API in the example here be the same whether or not you have two end points or use a viewset?

class People(generics.ListCreateAPIView):
    model = Person
    serializer_class = PersonSerializer

class Person(generics.RetrieveUpdateDestroyAPIView):
    model = Person
    serializer_class = PersonSerializer

urlpatterns = patterns('',
    url(r'^/people/(?P<pk>\d+)/$', Person.as_view()),
    url(r'^/people/$', People.as_view()),
)

[dustinfarris]

@cancan101:

• DRF returns JSON responses that are not immediately recognizable by Ember Data. The adapter transforms the DRF response into data that is understood by Ember Data.
• I have not heard of anyone using the adapter with nested routers, and would welcome feedback from your experiences with it
• Yes, a viewset accomplishes the same requirement

@toranb: the README is getting pretty long and potentially confusing, we may want to consider revising it and maybe move some of it to a wiki

/cc @craigteegarden

[toranb]

I couldn't agree more - it's grown a bit over time as you know :)

Do you know of a good example OSS project that does this well? what external resource do people want to see used here? is "readthedocs" still a thing? do you guys like/want to use it or something else?

[dustinfarris]

I think Sphinx + RTD is better suited for Python projects, although I have seen it used in other domains.

It lately seems popular to leverage GitHub Pages for this sort of thing. We would have to decide on a domain name to use. The ember-cli documentation is a good example: iamstef.net/ember-cli/

We could always use GitHub's Wiki service.

[dustinfarris]

I have cleaned up the README and moved a lot of the information to the wiki. Installation/Usage info should be easier to consume now.