  Using Django REST framework can be as simple as adding a few lines to your urlconf.
  
  ``urls.py``::
  
      from django.conf.urls.defaults import patterns, url
      from djangorestframework.resources import ModelResource
 
</s> remove Django REST framework comes with two "getting started" examples.

#. :doc:`examples/views`
#. :doc:`examples/modelviews`

Examples
--------

There are a few real world web API examples included with Django REST framework.

#. :doc:`examples/objectstore` - Using :class:`views.View` classes for APIs that do not map to models.
#. :doc:`examples/pygments` - Using :class:`views.View` classes with forms for input validation.
#. :doc:`examples/blogpost` - Using :class:`views.ModelView` classes for APIs that map directly to models.

All the examples are freely available for testing in the sandbox:

    http://rest.ep.io

(The :doc:`examples/sandbox` resource is also documented.)


 </s> add  </s> remove   examples.rst
 </s> add   contents </s> remove   :maxdepth: 2
 </s> add   :hidden:  </s> remove   library/authentication
  library/compat
  library/mixins
  library/parsers
  library/permissions
  library/renderers
  library/resource
  library/response
  library/serializer
  library/status
  library/views

Example Reference
-----------------
 </s> add .. include:: examples.rst </s> remove .. toctree::
  :maxdepth: 1
 </s> add 
The following example exposes your `MyModel` model through an api. It will provide two views:

 * A view which lists your model instances and simultaniously allows creation of instances 
   from that view.

 * Another view which lets you view, update or delete  your model instances individually.

  Using Django REST framework can be as simple as adding a few lines to your urlconf.
  
The following example exposes your `MyModel` model through an api. It will provide two views:

 * A view which lists your model instances and simultaniously allows creation of instances 
   from that view.

 * Another view which lets you view, update or delete  your model instances individually.

  ``urls.py``::
  
      from django.conf.urls.defaults import patterns, url
      from djangorestframework.resources import ModelResource
keep add keep keep keep keep
 some more refactoring and some style enhancements. Just committing
to stay in sync. 
docs/index.rst