  
  .. toctree::
    :maxdepth: 2
  
    resource
    modelresource
    emitters
    parsers
    authenticators
    response
  
  
  Indices and tables
  ------------------
  
 
</s> remove Blah blah blah, examples here.
 </s> add There's a few real world examples included with django-rest-framework.
These demonstrate the following use cases:

#. Using :class:`.Resource` for resources that do not map to models.
#. Using :class:`.Resource` with forms for input validation.
#. Using :class:`.ModelResource` for resources that map directly to models.

All the examples are freely available for testing in the sandbox here: http://api.django-rest-framework.org

.. toctree::
  :maxdepth: 1

  examples/objectstore
  examples/pygments
  examples/blogpost

How Tos
-------

.. toctree::
  :maxdepth: 2

  howto/usingcurl </s> remove Add a toctree for examples
 </s> add .. note:: </s> remove class BlogPostCreator(ModelResource):
    """A resource with which blog posts may be created."""
    allowed_methods = ('POST',)
 </s> add class BlogPostRoot(RootModelResource):
    """A resource with which lists all existing blog posts and creates new blog posts."""
    allowed_methods = ('GET', 'POST',) </s> remove 
##### Comment Resources #####

COMMENT_FIELDS = ('username', 'comment', 'created', 'rating', 'absolute_url', 'blogpost_url')

class CommentList(QueryModelResource):
    """A resource which lists all existing comments for a given blog post."""
    allowed_methods = ('GET', )
    model = Comment
    fields = COMMENT_FIELDS

class CommentCreator(ModelResource):
    """A resource with which blog comments may be created for a given blog post."""
    allowed_methods = ('POST',)
 </s> add class CommentRoot(RootModelResource):
    """A resource which lists all existing comments for a given blog post, and creates new blog comments for a given blog post."""
    allowed_methods = ('GET', 'POST',)
  library/resource
  library/modelresource
  library/emitters
  library/parsers
  library/authenticators
  library/response
  
  .. toctree::
    :maxdepth: 2
  
  library/resource
  library/modelresource
  library/emitters
  library/parsers
  library/authenticators
  library/response
  library/resource
  library/modelresource
  library/emitters
  library/parsers
  library/authenticators
  library/response
  library/resource
  library/modelresource
  library/emitters
  library/parsers
  library/authenticators
  library/response
  library/resource
  library/modelresource
  library/emitters
  library/parsers
  library/authenticators
  library/response
  library/resource
  library/modelresource
  library/emitters
  library/parsers
  library/authenticators
  library/response
  library/resource
  library/modelresource
  library/emitters
  library/parsers
  library/authenticators
  library/response
  
  
  Indices and tables
  ------------------
  
keep keep keep keep replace replace replace replace replace replace keep keep keep keep keep
 Lots of docs, trying to tidy up examples... 
docs/index.rst