  .. note::
  
  
  Library Reference
  -----------------
  
  .. toctree::
    :maxdepth: 2
 
</s> remove Add a toctree for examples
 </s> add .. note:: </s> remove   resource
  modelresource
  emitters
  parsers
  authenticators
  response
 </s> add   library/resource
  library/modelresource
  library/emitters
  library/parsers
  library/authenticators
  library/response </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         return ('blogpost.views.CommentList', (), {'blogpost_id': self.key})

    @property
    @models.permalink
    def comment_url(self):
        """Link to a resource which can create a comment for this blog post."""
        return ('blogpost.views.CommentCreator', (), {'blogpost_id': self.key})
 </s> add         return ('blogpost.views.CommentRoot', (), {'blogpost_id': self.key})
    TODO
  .. note::
  
    TODO
  
  Library Reference
  -----------------
  
  .. toctree::
    :maxdepth: 2
keep add keep keep keep keep keep keep
 Lots of docs, trying to tidy up examples... 
docs/index.rst