From e628d9eb9b7deac2ecffe23eace5c72709887f8f Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Fri, 6 Mar 2015 12:05:16 +0000 Subject: [PATCH] Update documentation --- .DS_Store | Bin 0 -> 15364 bytes api-guide/authentication/index.html | 151 ++-- api-guide/content-negotiation/index.html | 34 +- api-guide/exceptions/index.html | 55 +- api-guide/fields/index.html | 35 +- api-guide/filtering/index.html | 32 +- api-guide/format-suffixes/index.html | 32 +- api-guide/generic-views/index.html | 38 +- api-guide/metadata/index.html | 32 +- api-guide/pagination/index.html | 405 +++++++---- api-guide/parsers/index.html | 106 +-- api-guide/permissions/index.html | 46 +- api-guide/relations/index.html | 32 +- api-guide/renderers/index.html | 160 ++-- api-guide/requests/index.html | 34 +- api-guide/responses/index.html | 32 +- api-guide/reverse/index.html | 32 +- api-guide/routers/index.html | 32 +- api-guide/serializers/index.html | 85 ++- api-guide/settings/index.html | 53 +- api-guide/status-codes/index.html | 32 +- api-guide/testing/index.html | 46 +- api-guide/throttling/index.html | 32 +- api-guide/validators/index.html | 32 +- api-guide/versioning/index.html | 612 ++++++++++++++++ api-guide/views/index.html | 32 +- api-guide/viewsets/index.html | 34 +- css/default.css | 23 + img/.DS_Store | Bin 0 -> 15364 bytes img/cursor-pagination.png | Bin 0 -> 12221 bytes img/link-header-pagination.png | Bin 0 -> 35799 bytes img/pages-pagination.png | Bin 0 -> 10229 bytes img/sponsors/.DS_Store | Bin 0 -> 15364 bytes index.html | 48 +- topics/2.2-announcement/index.html | 546 -------------- topics/2.3-announcement/index.html | 683 ------------------ topics/3.0-announcement/index.html | 36 +- .../index.html | 303 ++++---- topics/ajax-csrf-cors/index.html | 34 +- topics/browsable-api/index.html | 32 +- topics/browser-enhancements/index.html | 32 +- topics/contributing/index.html | 32 +- topics/credits/index.html | 626 ---------------- topics/documenting-your-api/index.html | 34 +- .../index.html | 202 +++--- topics/kickstarter-announcement/index.html | 34 +- topics/project-management/index.html | 87 ++- topics/release-notes/index.html | 561 +------------- topics/rest-hypermedia-hateoas/index.html | 32 +- topics/third-party-resources/index.html | 33 +- tutorial/1-serialization/index.html | 32 +- tutorial/2-requests-and-responses/index.html | 34 +- tutorial/3-class-based-views/index.html | 32 +- .../index.html | 32 +- .../index.html | 34 +- tutorial/6-viewsets-and-routers/index.html | 32 +- tutorial/quickstart/index.html | 34 +- 57 files changed, 2013 insertions(+), 3841 deletions(-) create mode 100644 .DS_Store create mode 100644 api-guide/versioning/index.html create mode 100644 img/.DS_Store create mode 100644 img/cursor-pagination.png create mode 100644 img/link-header-pagination.png create mode 100644 img/pages-pagination.png create mode 100644 img/sponsors/.DS_Store delete mode 100644 topics/2.2-announcement/index.html delete mode 100644 topics/2.3-announcement/index.html rename topics/{2.4-announcement => 3.1-announcement}/index.html (53%) delete mode 100644 topics/credits/index.html rename topics/{rest-framework-2-announcement => internationalization}/index.html (62%) diff --git a/.DS_Store b/.DS_Store new file mode 100644 index 0000000000000000000000000000000000000000..1ea84ba6c8398d3ff323abc754aec83eb6954986 GIT binary patch literal 15364 zcmeHMUu+ab7@uETU{CgB`43gXQ|Iy)PKxx z&JYizcnbss0#gy-XZKQOupu^(9-er9Hx1XTsrdmVrDZc_&XOV#N$%}5EX^KH*f~pc zdy<3paMIB9wCe2f^PcME+=S}*nhw<)B#oa>*|tgf-mrD2p?QOS%Holc`VG~w+PeDD z>exvA+I7{jx^*?9qY+7pC`?+o;-1ahQtHUz(Z?PS+(x+cS#(kuN5*3?GWqZh0+-U+ zAckKQr5MF+v*qaRbCkLB<}X;dXz`Mz<#*gUui~y)pE5tKX7&v@JhUd;w4H>R)BBV; zE(O_|v8@hA&l~!1m!}`_lExuY&6{MfQ`h#6SEUYSsm+4%3cu49N7t>M0msnV`}*6D19NRQIY}fD%+v=X6?e6tQ_w=DwtKX&(xd-i8-pqYicU+QF?7Q}uYFanjt%U7) z_E5L#II1ND7LTk(8wl z>6P)0u&4O;&`x5jStCobUbdf&v19BFc9NZDXV^t{8KsC~5msO|s!@k6h@%xd(E|-S z29U*m|UTqAAj z{v^yrbtK|jEiI4Ay&8?T!`8T+rks=lO+|S$+QT(Xj!th)l6->|l~Fn6Qp}1PHe6LD z%c*^|^c6Skw0eyk-Q^Qa(ISCa?OHk7nGaa0Y!55fFO;KQ8GC4moOZ*yjhmv;y?od< z)%Du5xEi0>KtyyTE>Bzq2dsFZMV42MiJ7;1VoFIVy24YEX-fXh0(pXhItvLJ}$L z!d_x!Ke2LIbHyjxvj{2gz?u^o}Z$&p2+ps)~vwv?c;=^_r-xl={r)T25+Z zhR<2HavBAFCrh=ULU0fB%(Kp-FxxMdM24LpzW`~R)e|Nno>#wQ#X2nYnO zj{wS=lg$ZgSGZuAY{Ku_WAr>i4^O<^SRj29dR_HL02TOkynm%cy6{TFw~JFfw;v0n zZ%$?3oMdpDf5ZO_5a<61SB^LA21}g(Z{qVmUw40{sp*;GGqV% literal 0 HcmV?d00001 diff --git a/api-guide/authentication/index.html b/api-guide/authentication/index.html index 7a523c630..bf3048977 100644 --- a/api-guide/authentication/index.html +++ b/api-guide/authentication/index.html @@ -188,6 +188,10 @@ Pagination +
  • + Versioning +
    • +
  • Content negotiation
    • @@ -231,6 +235,10 @@ Documenting your API +
  • + Internationalization +
    • +
  • AJAX, CSRF & CORS
    • @@ -259,26 +267,14 @@ Project management -
  • - 2.0 Announcement -
    • - -
  • - 2.2 Announcement -
    • - -
  • - 2.3 Announcement -
    • - -
  • - 2.4 Announcement -
    • -
  • 3.0 Announcement
    • +
  • + 3.1 Announcement +
    • +
  • Kickstarter Announcement
    • @@ -287,10 +283,6 @@ Release Notes -
  • - Credits -
    • - @@ -393,14 +385,6 @@ SessionAuthentication -
  • - OAuthAuthentication -
    • - -
  • - OAuth2Authentication -
    • - @@ -422,11 +406,15 @@
  • - Digest Authentication + Django OAuth Toolkit
  • - Django OAuth Toolkit + Django REST framework OAuth +
    • + +
  • + Digest Authentication
  • @@ -449,6 +437,10 @@ Djoser
    • +
  • + django-rest-auth +
    • + @@ -649,74 +641,6 @@ python manage.py createsuperuser

    Unauthenticated responses that are denied permission will result in an HTTP 403 Forbidden response.

    If you're using an AJAX style API with SessionAuthentication, you'll need to make sure you include a valid CSRF token for any "unsafe" HTTP method calls, such as PUT, PATCH, POST or DELETE requests. See the Django CSRF documentation for more details.

    -

    OAuthAuthentication

    -

    This authentication uses OAuth 1.0a authentication scheme. OAuth 1.0a provides signature validation which provides a reasonable level of security over plain non-HTTPS connections. However, it may also be considered more complicated than OAuth2, as it requires clients to sign their requests.

    -

    This authentication class depends on the optional django-oauth-plus and oauth2 packages. In order to make it work you must install these packages and add oauth_provider to your INSTALLED_APPS:

    -
    INSTALLED_APPS = (
-    ...
-    `oauth_provider`,
-)
-
    -

    Don't forget to run syncdb once you've added the package.

    -
    python manage.py syncdb
-
    -

    Getting started with django-oauth-plus

    -

    The OAuthAuthentication class only provides token verification and signature validation for requests. It doesn't provide authorization flow for your clients. You still need to implement your own views for accessing and authorizing tokens.

    -

    The django-oauth-plus package provides simple foundation for classic 'three-legged' oauth flow. Please refer to the documentation for more details.

    -

    OAuth2Authentication

    -

    This authentication uses OAuth 2.0 authentication scheme. OAuth2 is more simple to work with than OAuth1, and provides much better security than simple token authentication. It is an unauthenticated scheme, and requires you to use an HTTPS connection.

    -

    This authentication class depends on the optional django-oauth2-provider project. In order to make it work you must install this package and add provider and provider.oauth2 to your INSTALLED_APPS:

    -
    INSTALLED_APPS = (
-    ...
-    'provider',
-    'provider.oauth2',
-)
-
    -

    Then add OAuth2Authentication to your global DEFAULT_AUTHENTICATION_CLASSES setting:

    -
    'DEFAULT_AUTHENTICATION_CLASSES': (
-    'rest_framework.authentication.OAuth2Authentication',
-),
-
    -

    You must also include the following in your root urls.py module:

    -
    url(r'^oauth2/', include('provider.oauth2.urls', namespace='oauth2')),
-
    -

    Note that the namespace='oauth2' argument is required.

    -

    Finally, sync your database.

    -
    python manage.py syncdb
-python manage.py migrate
-
    -
    -

    Note: If you use OAuth2Authentication in production you must ensure that your API is only available over https.

    -
    -

    Getting started with django-oauth2-provider

    -

    The OAuth2Authentication class only provides token verification for requests. It doesn't provide authorization flow for your clients.

    -

    The OAuth 2 authorization flow is taken care by the django-oauth2-provider dependency. A walkthrough is given here, but for more details you should refer to the documentation.

    -

    To get started:

    -
    1. Create a client
    -

    You can create a client, either through the shell, or by using the Django admin.

    -

    Go to the admin panel and create a new Provider.Client entry. It will create the client_id and client_secret properties for you.

    -
    2. Request an access token
    -

    To request an access token, submit a POST request to the url /oauth2/access_token with the following fields:

    -
      -
    • client_id the client id you've just configured at the previous step.
      • -
    • client_secret again configured at the previous step.
      • -
    • username the username with which you want to log in.
      • -
    • password well, that speaks for itself.
      • -
    -

    You can use the command line to test that your local configuration is working:

    -
    curl -X POST -d "client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=password&username=YOUR_USERNAME&password=YOUR_PASSWORD" http://localhost:8000/oauth2/access_token/
-
    -

    You should get a response that looks something like this:

    -
    {"access_token": "<your-access-token>", "scope": "read", "expires_in": 86399, "refresh_token": "<your-refresh-token>"}
-
    -
    3. Access the API
    -

    The only thing needed to make the OAuth2Authentication class work is to insert the access_token you've received in the Authorization request header.

    -

    The command line to test the authentication looks like:

    -
    curl -H "Authorization: Bearer <your-access-token>" http://localhost:8000/api/
-
    -

    Alternative OAuth 2 implementations

    -

    Note that Django OAuth Toolkit is an alternative external package that also includes OAuth 2.0 support for REST framework.

    -

    Custom authentication

    To implement a custom authentication scheme, subclass BaseAuthentication and override the .authenticate(self, request) method. The method should return a two-tuple of (user, auth) if authentication succeeds, or None otherwise.

    In some circumstances instead of returning None, you may want to raise an AuthenticationFailed exception from the .authenticate() method.

    @@ -749,10 +673,35 @@ class ExampleAuthentication(authentication.BaseAuthentication):

    Third party packages

    The following third party packages are also available.

    +

    Django OAuth Toolkit

    +

    The Django OAuth Toolkit package provides OAuth 2.0 support, and works with Python 2.7 and Python 3.3+. The package is maintained by Evonove and uses the excellent OAuthLib. The package is well documented, and well supported and is currently our recommended package for OAuth 2.0 support.

    +

    Installation & configuration

    +

    Install using pip.

    +
    pip install django-oauth-toolkit
+
    +

    Add the package to your INSTALLED_APPS and modify your REST framework settings.

    +
    INSTALLED_APPS = (
+    ...
+    'oauth2_provider',
+)
+
+REST_FRAMEWORK = {
+    'DEFAULT_AUTHENTICATION_CLASSES': (
+        'oauth2_provider.ext.rest_framework.OAuth2Authentication',
+    )
+}
+
    +

    For more details see the Django REST framework - Getting started documentation.

    +

    Django REST framework OAuth

    +

    The Django REST framework OAuth package provides both OAuth1 and OAuth2 support for REST framework.

    +

    This package was previously included directly in REST framework but is now supported and maintained as a third party package.

    +

    Installation & configuration

    +

    Install the package using pip.

    +
    pip install djangorestframework-oauth
+
    +

    For details on configuration and usage see the Django REST framework OAuth documentation for authentication and permissions.

    Digest Authentication

    HTTP digest authentication is a widely implemented scheme that was intended to replace HTTP basic authentication, and which provides a simple encrypted authentication mechanism. Juan Riaza maintains the djangorestframework-digestauth package which provides HTTP digest authentication support for REST framework.

    -

    Django OAuth Toolkit

    -

    The Django OAuth Toolkit package provides OAuth 2.0 support, and works with Python 2.7 and Python 3.3+. The package is maintained by Evonove and uses the excellent OAuthLib. The package is well documented, and comes as a recommended alternative for OAuth 2.0 support.

    Django OAuth2 Consumer

    The Django OAuth2 Consumer library from Rediker Software is another package that provides OAuth 2.0 support for REST framework. The package includes token scoping permissions on tokens, which allows finer-grained access to your API.

    JSON Web Token Authentication

    @@ -763,6 +712,8 @@ class ExampleAuthentication(authentication.BaseAuthentication):

    HTTP Signature (currently a IETF draft) provides a way to achieve origin authentication and message integrity for HTTP messages. Similar to Amazon's HTTP Signature scheme, used by many of its services, it permits stateless, per-request authentication. Elvio Toccalino maintains the djangorestframework-httpsignature package which provides an easy to use HTTP Signature Authentication mechanism.

    Djoser

    Djoser library provides a set of views to handle basic actions such as registration, login, logout, password reset and account activation. The package works with a custom user model and it uses token based authentication. This is a ready to use REST implementation of Django authentication system.

    +

    django-rest-auth

    +

    Django-rest-auth library provides a set of REST API endpoints for registration, authentication (including social media authentication), password reset, retrieve and update user details, etc. By having these API endpoints, your client apps such as AngularJS, iOS, Android, and others can communicate to your Django backend site independently via REST APIs for user management.

    diff --git a/api-guide/content-negotiation/index.html b/api-guide/content-negotiation/index.html index fcc0ff3a0..ebde1d6b9 100644 --- a/api-guide/content-negotiation/index.html +++ b/api-guide/content-negotiation/index.html @@ -65,7 +65,7 @@ - Search @@ -188,6 +188,10 @@ Pagination +
  • + Versioning +
    • +
  • Content negotiation
    • @@ -231,6 +235,10 @@ Documenting your API +
  • + Internationalization +
    • +
  • AJAX, CSRF & CORS
    • @@ -259,26 +267,14 @@ Project management -
  • - 2.0 Announcement -
    • - -
  • - 2.2 Announcement -
    • - -
  • - 2.3 Announcement -
    • - -
  • - 2.4 Announcement -
    • -
  • 3.0 Announcement
    • +
  • + 3.1 Announcement +
    • +
  • Kickstarter Announcement
    • @@ -287,10 +283,6 @@ Release Notes -
  • - Credits -
    • - diff --git a/api-guide/exceptions/index.html b/api-guide/exceptions/index.html index f9403f1d0..c0ddeb4fe 100644 --- a/api-guide/exceptions/index.html +++ b/api-guide/exceptions/index.html @@ -188,6 +188,10 @@ Pagination +
  • + Versioning +
    • +
  • Content negotiation
    • @@ -231,6 +235,10 @@ Documenting your API +
  • + Internationalization +
    • +
  • AJAX, CSRF & CORS
    • @@ -259,26 +267,14 @@ Project management -
  • - 2.0 Announcement -
    • - -
  • - 2.2 Announcement -
    • - -
  • - 2.3 Announcement -
    • - -
  • - 2.4 Announcement -
    • -
  • 3.0 Announcement
    • +
  • + 3.1 Announcement +
    • +
  • Kickstarter Announcement
    • @@ -287,10 +283,6 @@ Release Notes -
  • - Credits -
    • - @@ -393,10 +385,18 @@ PermissionDenied +
  • + NotFound +
    • +
  • MethodNotAllowed
    • +
  • + NotAcceptable +
    • +
  • UnsupportedMediaType
    • @@ -464,7 +464,7 @@ Content-Length: 94

    Custom exception handling

    You can implement custom exception handling by creating a handler function that converts exceptions raised in your API views into response objects. This allows you to control the style of error responses used by your API.

    -

    The function must take a single argument, which is the exception to be handled, and should either return a Response object, or return None if the exception cannot be handled. If the handler returns None then the exception will be re-raised and Django will return a standard HTTP 500 'server error' response.

    +

    The function must take a pair of arguments, this first is the exception to be handled, and the second is a dictionary containing any extra context such as the view currently being handled. The exception handler function should either return a Response object, or return None if the exception cannot be handled. If the handler returns None then the exception will be re-raised and Django will return a standard HTTP 500 'server error' response.

    For example, you might want to ensure that all error responses include the HTTP status code in the body of the response, like so:

    HTTP/1.1 405 Method Not Allowed
 Content-Type: application/json
@@ -475,10 +475,10 @@ Content-Length: 62
 
    In order to alter the style of the response, you could write the following custom exception handler:
    
 
    from rest_framework.views import exception_handler
 
-def custom_exception_handler(exc):
+def custom_exception_handler(exc, context):
     # Call REST framework's default exception handler first,
     # to get the standard error response.
-    response = exception_handler(exc)
+    response = exception_handler(exc, context)
 
     # Now add the HTTP status code to the response.
     if response is not None:
@@ -486,6 +486,7 @@ def custom_exception_handler(exc):
 
     return response
 
    
+
    The context argument is not used by the default handler, but can be useful if the exception handler needs further information such as the view currently being handled, which can be accessed as context['view'].
    
 
    The exception handler must also be configured in your settings, using the EXCEPTION_HANDLER setting key. For example:
    
 
    REST_FRAMEWORK = {
     'EXCEPTION_HANDLER': 'my_project.my_app.utils.custom_exception_handler'
@@ -526,10 +527,18 @@ class ServiceUnavailable(APIException):
 
    Signature: PermissionDenied(detail=None)
    
 
    Raised when an authenticated request fails the permission checks.
    
 
    By default this exception results in a response with the HTTP status code "403 Forbidden".
    
+
    NotFound
    
+
    Signature: NotFound(detail=None)
    
+
    Raised when a resource does not exists at the given URL. This exception is equivalent to the standard Http404 Django exception.
    
+
    By default this exception results in a response with the HTTP status code "404 Not Found".
    
 
    MethodNotAllowed
    
 
    Signature: MethodNotAllowed(method, detail=None)
    
 
    Raised when an incoming request occurs that does not map to a handler method on the view.
    
 
    By default this exception results in a response with the HTTP status code "405 Method Not Allowed".
    
+
    NotAcceptable
    
+
    Signature: NotAcceptable(detail=None)
    
+
    Raised when an incoming request occurs with an Accept header that cannot be satisfied by any of the available renderers.
    
+
    By default this exception results in a response with the HTTP status code "406 Not Acceptable".
    
 
    UnsupportedMediaType
    
 
    Signature: UnsupportedMediaType(media_type, detail=None)
    
 
    Raised if there are no parsers that can handle the content type of the request data when accessing request.data.
    
diff --git a/api-guide/fields/index.html b/api-guide/fields/index.html
index 9fd73553f..1b7019fe0 100644
--- a/api-guide/fields/index.html
+++ b/api-guide/fields/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -661,11 +653,12 @@ color_channel = serializers.ChoiceField(
 
    CharField
    
 
    A text representation. Optionally validates the text to be shorter than max_length and longer than min_length.
    
 
    Corresponds to django.db.models.fields.CharField or django.db.models.fields.TextField.
    
-
    Signature: CharField(max_length=None, min_length=None, allow_blank=False)
    
+
    Signature: CharField(max_length=None, min_length=None, allow_blank=False, trim_whitespace=True)
    
 
      
 
    • max_length - Validates that the input contains no more than this number of characters.
      • 
 
    • min_length - Validates that the input contains no fewer than this number of characters.
      • 
 
    • allow_blank - If set to True then the empty string should be considered a valid value. If set to False then the empty string is considered invalid and will raise a validation error. Defaults to False.
      • 
+
    • trim_whitespace - If set to True then leading and trailing whitespace is trimmed. Defaults to True.
      • 
 
    
 
    The allow_null option is also available for string fields, although its usage is discouraged in favor of allow_blank. It is valid to set both allow_blank=True and allow_null=True, but doing so means that there will be two differing types of empty value permissible for string representations, which can lead to data inconsistencies and subtle application bugs.
    
 
    EmailField
    
diff --git a/api-guide/filtering/index.html b/api-guide/filtering/index.html
index 7cf57f6b6..fc8dafb20 100644
--- a/api-guide/filtering/index.html
+++ b/api-guide/filtering/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
diff --git a/api-guide/format-suffixes/index.html b/api-guide/format-suffixes/index.html
index d7d74db91..a01438d83 100644
--- a/api-guide/format-suffixes/index.html
+++ b/api-guide/format-suffixes/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
diff --git a/api-guide/generic-views/index.html b/api-guide/generic-views/index.html
index 082f0bb09..288a71158 100644
--- a/api-guide/generic-views/index.html
+++ b/api-guide/generic-views/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -568,11 +560,9 @@ class UserList(generics.ListCreateAPIView):
 
    Pagination:
    
 
    The following attributes are used to control pagination when used with list views.
    
 
      
-
    • paginate_by - The size of pages to use with paginated data.  If set to None then pagination is turned off.  If unset this uses the same value as the PAGINATE_BY setting, which defaults to None.
      • 
-
    • paginate_by_param - The name of a query parameter, which can be used by the client to override the default page size to use for pagination.  If unset this uses the same value as the PAGINATE_BY_PARAM setting, which defaults to None.
      • 
-
    • pagination_serializer_class - The pagination serializer class to use when determining the style of paginated responses.  Defaults to the same value as the DEFAULT_PAGINATION_SERIALIZER_CLASS setting.
      • 
-
    • page_kwarg - The name of a URL kwarg or URL query parameter which can be used by the client to control which page is requested.  Defaults to 'page'.
      • 
+
    • pagination_class - The pagination class that should be used when paginating list results. Defaults to the same value as the DEFAULT_PAGINATION_CLASS setting, which is 'rest_framework.pagination.PageNumberPagination'.
      • 
 
    
+
    Note that usage of the paginate_by, paginate_by_param and page_kwarg attributes are now pending deprecation. The pagination_serializer_class attribute and DEFAULT_PAGINATION_SERIALIZER_CLASS setting have been removed completely. Pagination settings should instead be controlled by overriding a pagination class and setting any configuration attributes there. See the pagination documentation for more details.
    
 
    Filtering:
    
 
               
                
diff --git a/api-guide/pagination/index.html b/api-guide/pagination/index.html
index 5e8f2a82f..37cb383ed 100644
--- a/api-guide/pagination/index.html
+++ b/api-guide/pagination/index.html
@@ -62,7 +62,7 @@
       
    
         
    
           GitHub
-          
           Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -358,22 +350,38 @@
 
                   
                     
  • 
-                      Paginating basic data
+                      Setting the pagination style
                     
    • 
                   
                     
  • 
-                      Paginating QuerySets
-                    
    • 
-                  
-                    
  • 
-                      Pagination in the generic views
+                      Modifying the pagination style
                     
    • 
                   
 
                 
 
                   
  • 
-                    Custom pagination serializers
+                    API Reference
+                  
    • 
+
+                  
+                    
  • 
+                      PageNumberPagination
+                    
    • 
+                  
+                    
  • 
+                      LimitOffsetPagination
+                    
    • 
+                  
+                    
  • 
+                      CursorPagination
+                    
    • 
+                  
+
+                
+
+                  
  • 
+                    Custom pagination styles
                   
    • 
 
                   
@@ -382,7 +390,23 @@
                     
                   
                     
  • 
-                      Using your custom pagination serializer
+                      Header based pagination
+                    
    • 
+                  
+                    
  • 
+                      Using your custom pagination class
+                    
    • 
+                  
+
+                
+
+                  
  • 
+                    HTML pagination controls
+                  
    • 
+
+                  
+                    
  • 
+                      Customizing the controls
                     
    • 
                   
 
@@ -421,123 +445,230 @@
 
    Django provides a few classes that help you manage paginated data – that is, data that’s split across several pages, with “Previous/Next” links.
    
 
    — Django documentation
    
 
-
    REST framework includes a PaginationSerializer class that makes it easy to return paginated data in a way that can then be rendered to arbitrary media types.
    
-
    Paginating basic data
    
-
    Let's start by taking a look at an example from the Django documentation.
    
-
    from django.core.paginator import Paginator
-
-objects = ['john', 'paul', 'george', 'ringo']
-paginator = Paginator(objects, 2)
-page = paginator.page(1)
-page.object_list
-# ['john', 'paul']
-
    
-
    At this point we've got a page object.  If we wanted to return this page object as a JSON response, we'd need to provide the client with context such as next and previous links, so that it would be able to page through the remaining results.
    
-
    from rest_framework.pagination import PaginationSerializer
-
-serializer = PaginationSerializer(instance=page)
-serializer.data
-# {'count': 4, 'next': '?page=2', 'previous': None, 'results': [u'john', u'paul']}
-
    
-
    The context argument of the PaginationSerializer class may optionally include the request.  If the request is included in the context then the next and previous links returned by the serializer will use absolute URLs instead of relative URLs.
    
-
    request = RequestFactory().get('/foobar')
-serializer = PaginationSerializer(instance=page, context={'request': request})
-serializer.data
-# {'count': 4, 'next': 'http://testserver/foobar?page=2', 'previous': None, 'results': [u'john', u'paul']}
-
    
-
    We could now return that data in a Response object, and it would be rendered into the correct media type.
    
-
    Paginating QuerySets
    
-
    Our first example worked because we were using primitive objects.  If we wanted to paginate a queryset or other complex data, we'd need to specify a serializer to use to serialize the result set itself.
    
-
    We can do this using the object_serializer_class attribute on the inner Meta class of the pagination serializer.  For example.
    
-
    class UserSerializer(serializers.ModelSerializer):
-    """
-    Serializes user querysets.
-    """
-    class Meta:
-        model = User
-        fields = ('username', 'email')
-
-class PaginatedUserSerializer(pagination.PaginationSerializer):
-    """
-    Serializes page objects of user querysets.
-    """
-    class Meta:
-        object_serializer_class = UserSerializer
-
    
-
    We could now use our pagination serializer in a view like this.
    
-
    @api_view('GET')
-def user_list(request):
-    queryset = User.objects.all()
-    paginator = Paginator(queryset, 20)
-
-    page = request.QUERY_PARAMS.get('page')
-    try:
-        users = paginator.page(page)
-    except PageNotAnInteger:
-        # If page is not an integer, deliver first page.
-        users = paginator.page(1)
-    except EmptyPage:
-        # If page is out of range (e.g. 9999),
-        # deliver last page of results.
-        users = paginator.page(paginator.num_pages)
-
-    serializer_context = {'request': request}
-    serializer = PaginatedUserSerializer(users,
-                                         context=serializer_context)
-    return Response(serializer.data)
-
    
-
    Pagination in the generic views
    
-
    The generic class based views ListAPIView and ListCreateAPIView provide pagination of the returned querysets by default.  You can customise this behaviour by altering the pagination style, by modifying the default number of results, by allowing clients to override the page size using a query parameter, or by turning pagination off completely.
    
-
    The default pagination style may be set globally, using the DEFAULT_PAGINATION_SERIALIZER_CLASS, PAGINATE_BY, PAGINATE_BY_PARAM, and MAX_PAGINATE_BY settings.  For example.
    
+
    REST framework includes support for customizable pagination styles. This allows you to modify how large result sets are split into individual pages of data.
    
+
    The pagination API can support either:
    
+
      
+
    • Pagination links that are provided as part of the content of the response.
      • 
+
    • Pagination links that are included in response headers, such as Content-Range or Link.
      • 
+
    
+
    The built-in styles currently all use links included as part of the content of the response. This style is more accessible when using the browsable API.
    
+
    Pagination is only performed automatically if you're using the generic views or viewsets. If you're using a regular APIView, you'll need to call into the pagination API yourself to ensure you return a paginated response. See the source code for the mixins.ListMixin and generics.GenericAPIView classes for an example.
    
+
    Setting the pagination style
    
+
    The default pagination style may be set globally, using the DEFAULT_PAGINATION_CLASS settings key. For example, to use the built-in limit/offset pagination, you would do:
    
 
    REST_FRAMEWORK = {
-    'PAGINATE_BY': 10,                 # Default to 10
-    'PAGINATE_BY_PARAM': 'page_size',  # Allow client to override, using `?page_size=xxx`.
-    'MAX_PAGINATE_BY': 100             # Maximum limit allowed when using `?page_size=xxx`.
+    'DEFAULT_PAGINATION_CLASS': 'rest_framework.pagination.LimitOffsetPagination'
 }
 
    
-
    You can also set the pagination style on a per-view basis, using the ListAPIView generic class-based view.
    
-
    class PaginatedListView(ListAPIView):
-    queryset = ExampleModel.objects.all()
-    serializer_class = ExampleModelSerializer
-    paginate_by = 10
-    paginate_by_param = 'page_size'
-    max_paginate_by = 100
+
    You can also set the pagination class on an individual view by using the pagination_class attribute. Typically you'll want to use the same pagination style throughout your API, although you might want to vary individual aspects of the pagination, such as default or maximum page size, on a per-view basis.
    
+
    Modifying the pagination style
    
+
    If you want to modify particular aspects of the pagination style, you'll want to override one of the pagination classes, and set the attributes that you want to change.
    
+
    class LargeResultsSetPagination(PageNumberPagination):
+    page_size = 1000
+    page_size_query_param = 'page_size'
+    max_page_size = 10000
+
+class StandardResultsSetPagination(PageNumberPagination):
+    page_size = 100
+    page_size_query_param = 'page_size'
+    max_page_size = 1000
+
    
+
    You can then apply your new style to a view using the .pagination_class attribute:
    
+
    class BillingRecordsView(generics.ListAPIView):
+    queryset = Billing.objects.all()
+    serializer = BillingRecordsSerializer
+    pagination_class = LargeResultsSetPagination
+
    
+
    Or apply the style globally, using the DEFAULT_PAGINATION_CLASS settings key. For example:
    
+
    REST_FRAMEWORK = {
+    'DEFAULT_PAGINATION_CLASS': 'apps.core.pagination.StandardResultsSetPagination'
+    }
 
    
-
    Note that using a paginate_by value of None will turn off pagination for the view.
-Note if you use the PAGINATE_BY_PARAM settings, you also have to set the paginate_by_param attribute in your view to None in order to turn off pagination for those requests that contain the paginate_by_param parameter.
    
-
    For more complex requirements such as serialization that differs depending on the requested media type you can override the .get_paginate_by() and .get_pagination_serializer_class() methods.
    
 
    
-
    Custom pagination serializers
    
-
    To create a custom pagination serializer class you should override pagination.BasePaginationSerializer and set the fields that you want the serializer to return.
    
-
    You can also override the name used for the object list field, by setting the results_field attribute, which defaults to 'results'.
    
-
    Example
    
-
    For example, to nest a pair of links labelled 'prev' and 'next', and set the name for the results field to 'objects', you might use something like this.
    
-
    from rest_framework import pagination
-from rest_framework import serializers
-
-class LinksSerializer(serializers.Serializer):
-    next = pagination.NextPageField(source='*')
-    prev = pagination.PreviousPageField(source='*')
-
-class CustomPaginationSerializer(pagination.BasePaginationSerializer):
-    links = LinksSerializer(source='*')  # Takes the page object as the source
-    total_results = serializers.ReadOnlyField(source='paginator.count')
-
-    results_field = 'objects'
+
    API Reference
    
+
    PageNumberPagination
    
+
    This pagination style accepts a single number page number in the request query parameters.
    
+
    Request:
    
+
    GET https://api.example.org/accounts/?page=4
 
    
-
    Using your custom pagination serializer
    
-
    To have your custom pagination serializer be used by default, use the DEFAULT_PAGINATION_SERIALIZER_CLASS setting:
    
-
    REST_FRAMEWORK = {
-    'DEFAULT_PAGINATION_SERIALIZER_CLASS':
-        'example_app.pagination.CustomPaginationSerializer',
+
    Response:
    
+
    HTTP 200 OK
+{
+    "count": 1023
+    "next": "https://api.example.org/accounts/?page=5",
+    "previous": "https://api.example.org/accounts/?page=3",
+    "results": [
+       …
+    ]
 }
 
    
-
    Alternatively, to set your custom pagination serializer on a per-view basis, use the pagination_serializer_class attribute on a generic class based view:
    
-
    class PaginatedListView(generics.ListAPIView):
-    model = ExampleModel
-    pagination_serializer_class = CustomPaginationSerializer
-    paginate_by = 10
+
    Setup
    
+
    To enable the PageNumberPagination style globally, use the following configuration, modifying the DEFAULT_PAGE_SIZE as desired:
    
+
    REST_FRAMEWORK = {
+    'DEFAULT_PAGINATION_CLASS': 'rest_framework.pagination.PageNumberPagination',
+    'DEFAULT_PAGE_SIZE': 100
+}
 
    
+
    On GenericAPIView subclasses you may also set the pagination_class attribute to select PageNumberPagination on a per-view basis.
    
+
    Configuration
    
+
    The PageNumberPagination class includes a number of attributes that may be overridden to modify the pagination style.
    
+
    To set these attributes you should override the PageNumberPagination class, and then enable your custom pagination class as above.
    
+
      
+
    • page_size - A numeric value indicating the page size. If set, this overrides the DEFAULT_PAGE_SIZE setting. Defaults to the same value as the DEFAULT_PAGE_SIZE settings key.
      • 
+
    • page_query_param - A string value indicating the name of the query parameter to use for the pagination control.
      • 
+
    • page_size_query_param - If set, this is a string value indicating the name of a query parameter that allows the client to set the page size on a per-request basis. Defaults to None, indicating that the client may not control the requested page size.
      • 
+
    • max_page_size - If set, this is a numeric value indicating the maximum allowable requested page size. This attribute is only valid if page_size_query_param is also set.
      • 
+
    • last_page_strings - A list or tuple of string values indicating values that may be used with the page_query_param to request the final page in the set. Defaults to ('last',)
      • 
+
    • template - The name of a template to use when rendering pagination controls in the browsable API. May be overridden to modify the rendering style, or set to None to disable HTML pagination controls completely. Defaults to "rest_framework/pagination/numbers.html".
      • 
+
    
+
    
+
    LimitOffsetPagination
    
+
    This pagination style mirrors the syntax used when looking up multiple database records. The client includes both a "limit" and an 
+"offset" query parameter. The limit indicates the maximum number of items to return, and is equivalent to the page_size in other styles. The offset indicates the starting position of the query in relation to the complete set of unpaginated items.
    
+
    Request:
    
+
    GET https://api.example.org/accounts/?limit=100&offset=400
+
    
+
    Response:
    
+
    HTTP 200 OK
+{
+    "count": 1023
+    "next": "https://api.example.org/accounts/?limit=100&offset=500",
+    "previous": "https://api.example.org/accounts/?limit=100&offset=300",
+    "results": [
+       …
+    ]
+}
+
    
+
    Setup
    
+
    To enable the PageNumberPagination style globally, use the following configuration:
    
+
    REST_FRAMEWORK = {
+    'DEFAULT_PAGINATION_CLASS': 'rest_framework.pagination.LimitOffsetPagination'
+}
+
    
+
    Optionally, you may also set a DEFAULT_PAGE_SIZE key. If the DEFAULT_PAGE_SIZE parameter is also used then the limit query parameter will be optional, and may be omitted by the client.
    
+
    On GenericAPIView subclasses you may also set the pagination_class attribute to select LimitOffsetPagination on a per-view basis.
    
+
    Configuration
    
+
    The LimitOffsetPagination class includes a number of attributes that may be overridden to modify the pagination style.
    
+
    To set these attributes you should override the LimitOffsetPagination class, and then enable your custom pagination class as above.
    
+
      
+
    • default_limit - A numeric value indicating the limit to use if one is not provided by the client in a query parameter. Defaults to the same value as the DEFAULT_PAGE_SIZE settings key.
      • 
+
    • limit_query_param - A string value indicating the name of the "limit" query parameter. Defaults to 'limit'.
      • 
+
    • offset_query_param - A string value indicating the name of the "offset" query parameter. Defaults to 'offset'.
      • 
+
    • max_limit - If set this is a numeric value indicating the maximum allowable limit that may be requested by the client. Defaults to None.
      • 
+
    • template - The name of a template to use when rendering pagination controls in the browsable API. May be overridden to modify the rendering style, or set to None to disable HTML pagination controls completely. Defaults to "rest_framework/pagination/numbers.html".
      • 
+
    
+
    
+
    CursorPagination
    
+
    The cursor-based pagination presents an opaque "cursor" indicator that the client may use to page through the result set. This pagination style only presents forward and reverse controls, and does not allow the client to navigate to arbitrary positions.
    
+
    Cursor based pagination requires that there is a unique, unchanging ordering of items in the result set. This ordering might typically be a creation timestamp on the records, as this presents a consistent ordering to paginate against.
    
+
    Cursor based pagination is more complex than other schemes. It also requires that the result set presents a fixed ordering, and does not allow the client to arbitrarily index into the result set. However it does provide the following benefits:
    
+
      
+
    • Provides a consistent pagination view. When used properly CursorPagination ensures that the client will never see the same item twice when paging through records, even when new items are being inserted by other clients during the pagination process.
      • 
+
    • Supports usage with very large datasets. With extremely large datasets pagination using offset-based pagination styles may become inefficient or unusable. Cursor based pagination schemes instead have fixed-time properties, and do not slow down as the dataset size increases.
      • 
+
    
+
    Details and limitations
    
+
    Proper use of cursor based pagination a little attention to detail. You'll need to think about what ordering you want the scheme to be applied against. The default is to order by "-created". This assumes that there must be a 'created' timestamp field on the model instances, and will present a "timeline" style paginated view, with the most recently added items first.
    
+
    You can modify the ordering by overriding the 'ordering' attribute on the pagination class, or by using the OrderingFilter filter class together with CursorPagination. When used with OrderingFilter you should strongly consider restricting the fields that the user may order by.
    
+
    Proper usage of cursor pagination should have an ordering field that satisfies the following:
    
+
      
+
    • Should be an unchanging value, such as a timestamp, slug, or other field that is only set once, on creation.
      • 
+
    • Should be unique, or nearly unique. Millisecond precision timestamps are a good example. This implementation of cursor pagination uses a smart "position plus offset" style that allows it to properly support not-strictly-unique values as the ordering.
      • 
+
    • Should be a non-nullable value that can be coerced to a string.
      • 
+
    • The field should have a database index.
      • 
+
    
+
    Using an ordering field that does not satisfy these constraints will generally still work, but you'll be loosing some of the benefits of cursor pagination.
    
+
    For more technical details on the implementation we use for cursor pagination, the "Building cursors for the Disqus API" blog post gives a good overview of the basic approach.
    
+
    Setup
    
+
    To enable the CursorPagination style globally, use the following configuration, modifying the DEFAULT_PAGE_SIZE as desired:
    
+
    REST_FRAMEWORK = {
+    'DEFAULT_PAGINATION_CLASS': 'rest_framework.pagination.CursorPagination',
+    'DEFAULT_PAGE_SIZE': 100
+}
+
    
+
    On GenericAPIView subclasses you may also set the pagination_class attribute to select CursorPagination on a per-view basis.
    
+
    Configuration
    
+
    The CursorPagination class includes a number of attributes that may be overridden to modify the pagination style.
    
+
    To set these attributes you should override the CursorPagination class, and then enable your custom pagination class as above.
    
+
      
+
    • page_size = A numeric value indicating the page size. If set, this overrides the DEFAULT_PAGE_SIZE setting. Defaults to the same value as the DEFAULT_PAGE_SIZE settings key.
      • 
+
    • cursor_query_param = A string value indicating the name of the "cursor" query parameter. Defaults to 'cursor'.
      • 
+
    • ordering = This should be a string, or list of strings, indicating the field against which the cursor based pagination will be applied. For example: ordering = 'slug'. Defaults to -created. This value may also be overridden by using OrderingFilter on the view.
      • 
+
    • template = The name of a template to use when rendering pagination controls in the browsable API. May be overridden to modify the rendering style, or set to None to disable HTML pagination controls completely. Defaults to "rest_framework/pagination/previous_and_next.html".
      • 
+
    
+
    
+
    Custom pagination styles
    
+
    To create a custom pagination serializer class you should subclass pagination.BasePagination and override the paginate_queryset(self, queryset, request, view=None) and get_paginated_response(self, data) methods:
    
+
      
+
    • The paginate_queryset method is passed the initial queryset and should return an iterable object that contains only the data in the requested page.
      • 
+
    • The get_paginated_response method is passed the serialized page data and should return a Response instance.
      • 
+
    
+
    Note that the paginate_queryset method may set state on the pagination instance, that may later be used by the get_paginated_response method.
    
+
    Example
    
+
    Suppose we want to replace the default pagination output style with a modified format that  includes the next and previous links under in a nested 'links' key. We could specify a custom pagination class like so:
    
+
    class CustomPagination(pagination.PageNumberPagination):
+    def get_paginated_response(self, data):
+        return Response({
+            'links': {
+               'next': self.get_next_link(),
+               'previous': self.get_previous_link()
+            },
+            'count': self.page.paginator.count,
+            'results': data
+        })
+
    
+
    We'd then need to setup the custom class in our configuration:
    
+
    REST_FRAMEWORK = {
+    'DEFAULT_PAGINATION_CLASS': 'my_project.apps.core.pagination.CustomPagination',
+    'PAGE_SIZE': 100
+}
+
    
+
    Note that if you care about how the ordering of keys is displayed in responses in the browsable API you might choose to use an OrderedDict when constructing the body of paginated responses, but this is optional.
    
+
    Header based pagination
    
+
    Let's modify the built-in PageNumberPagination style, so that instead of include the pagination links in the body of the response, we'll instead include a Link header, in a similar style to the GitHub API.
    
+
    class LinkHeaderPagination(pagination.PageNumberPagination):
+    def get_paginated_response(self, data):
+        next_url = self.get_next_link()
+        previous_url = self.get_previous_link()
+
+        if next_url is not None and previous_url is not None:
+            link = '<{next_url}; rel="next">, <{previous_url}; rel="prev">'
+        elif next_url is not None:
+            link = '<{next_url}; rel="next">'
+        elif previous_url is not None:
+            link = '<{previous_url}; rel="prev">'
+        else:
+            link = ''
+
+        link = link.format(next_url=next_url, previous_url=previous_url)
+        headers = {'Link': link} if link else {}
+
+        return Response(data, headers=headers)
+
    
+
    Using your custom pagination class
    
+
    To have your custom pagination class be used by default, use the DEFAULT_PAGINATION_CLASS setting:
    
+
    REST_FRAMEWORK = {
+    'DEFAULT_PAGINATION_CLASS': 'my_project.apps.core.pagination.LinkHeaderPagination',
+    'PAGE_SIZE': 100
+}
+
    
+
    API responses for list endpoints will now include a Link header, instead of including the pagination links as part of the body of the response, for example:
    
+
    
+
    Link Header
    
+
    A custom pagination style, using the 'Link' header'
    
+
    
+
    HTML pagination controls
    
+
    By default using the pagination classes will cause HTML pagination controls to be displayed in the browsable API. There are two built-in display styles. The PageNumberPagination and LimitOffsetPagination classes display a list of page numbers with previous and next controls. The CursorPagination class displays a simpler style that only displays a previous and next control.
    
+
    Customizing the controls
    
+
    You can override the templates that render the HTML pagination controls. The two built-in styles are:
    
+
      
+
    • rest_framework/pagination/numbers.html
      • 
+
    • rest_framework/pagination/previous_and_next.html
      • 
+
    
+
    Providing a template with either of these paths in a global template directory will override the default rendering for the relevant pagination classes.
    
+
    Alternatively you can disable HTML pagination controls completely by subclassing on of the existing classes, setting template = None as an attribute on the class. You'll then need to configure your DEFAULT_PAGINATION_CLASS settings key to use your custom class as the default pagination style.
    
+
    Low-level API
    
+
    The low-level API for determining if a pagination class should display the controls or not is exposed as a display_page_controls attribute on the pagination instance. Custom pagination classes should be set to True in the paginate_queryset method if they require the HTML pagination controls to be displayed.
    
+
    The .to_html() and .get_html_context() methods may also be overridden in a custom pagination class in order to further customize how the controls are rendered.
    
+
    
 
    Third party packages
    
 
    The following third party packages are also available.
    
 
    DRF-extensions
    
diff --git a/api-guide/parsers/index.html b/api-guide/parsers/index.html
index e04f563e1..132d146df 100644
--- a/api-guide/parsers/index.html
+++ b/api-guide/parsers/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -377,14 +369,6 @@
                       JSONParser
                     
                   
-                    
  • 
-                      YAMLParser
-                    
    • 
-                  
-                    
  • 
-                      XMLParser
-                    
    • 
-                  
                     
  • 
                       FormParser
                     
    • 
@@ -429,6 +413,14 @@
                   
 
                   
+                    
  • 
+                      YAML
+                    
    • 
+                  
+                    
  • 
+                      XML
+                    
    • 
+                  
                     
  • 
                       MessagePack
                     
    • 
@@ -472,34 +464,34 @@ sending more complex data than simple forms
    
 
    As an example, if you are sending json encoded data using jQuery with the .ajax() method, you should make sure to include the contentType: 'application/json' setting.
    
 
    
 
    Setting the parsers
    
-
    The default set of parsers may be set globally, using the DEFAULT_PARSER_CLASSES setting.  For example, the following settings would allow requests with YAML content.
    
+
    The default set of parsers may be set globally, using the DEFAULT_PARSER_CLASSES setting. For example, the following settings would allow only requests with JSON content, instead of the default of JSON or form data.
    
 
    REST_FRAMEWORK = {
     'DEFAULT_PARSER_CLASSES': (
-        'rest_framework.parsers.YAMLParser',
+        'rest_framework.parsers.JSONParser',
     )
 }
 
    
 
    You can also set the parsers used for an individual view, or viewset,
 using the APIView class based views.
    
-
    from rest_framework.parsers import YAMLParser
+
    from rest_framework.parsers import JSONParser
 from rest_framework.response import Response
 from rest_framework.views import APIView
 
 class ExampleView(APIView):
     """
-    A view that can accept POST requests with YAML content.
+    A view that can accept POST requests with JSON content.
     """
-    parser_classes = (YAMLParser,)
+    parser_classes = (JSONParser,)
 
     def post(self, request, format=None):
         return Response({'received data': request.data})
 
    
 
    Or, if you're using the @api_view decorator with function based views.
    
 
    @api_view(['POST'])
-@parser_classes((YAMLParser,))
+@parser_classes((JSONParser,))
 def example_view(request, format=None):
     """
-    A view that can accept POST requests with YAML content.
+    A view that can accept POST requests with JSON content.
     """
     return Response({'received data': request.data})
 
    
@@ -508,16 +500,6 @@ def example_view(request, format=None):
 
    JSONParser
    
 
    Parses JSON request content.
    
 
    .media_type: application/json
    
-
    YAMLParser
    
-
    Parses YAML request content.
    
-
    Requires the pyyaml package to be installed.
    
-
    .media_type: application/yaml
    
-
    XMLParser
    
-
    Parses REST framework's default style of XML request content.
    
-
    Note that the XML markup language is typically used as the base language for more strictly defined domain-specific languages, such as RSS, Atom, and XHTML.
    
-
    If you are considering using XML for your API, you may want to consider implementing a custom renderer and parser for your specific requirements, and using an existing domain-specific media-type, or creating your own custom XML-based media-type.
    
-
    Requires the defusedxml package to be installed.
    
-
    .media_type: application/xml
    
 
    FormParser
    
 
    Parses HTML form content.  request.data will be populated with a QueryDict of data.
    
 
    You will typically want to use both FormParser and MultiPartParser together in order to fully support HTML form data.
    
@@ -561,7 +543,7 @@ def example_view(request, format=None):
 
    Optional.  If supplied, this argument will be a dictionary containing any additional context that may be required to parse the request content.
    
 
    By default this will include the following keys: view, request, args, kwargs.
    
 
    Example
    
-
    The following is an example plaintext parser that will populate the request.data property with a string representing the body of the request. 
    
+
    The following is an example plaintext parser that will populate the request.data property with a string representing the body of the request.
    
 
    class PlainTextParser(BaseParser):
 """
 Plain text parser.
@@ -578,6 +560,38 @@ def parse(self, stream, media_type=None, parser_context=None):
 
    
 
    Third party packages
    
 
    The following third party packages are also available.
    
+
    YAML
    
+
    REST framework YAML provides YAML parsing and rendering support. It was previously included directly in the REST framework package, and is now instead supported as a third-party package.
    
+
    Installation & configuration
    
+
    Install using pip.
    
+
    $ pip install djangorestframework-yaml
+
    
+
    Modify your REST framework settings.
    
+
    REST_FRAMEWORK = {
+    'DEFAULT_PARSER_CLASSES': (
+        'rest_framework_yaml.parsers.YAMLParser',
+    ),
+    'DEFAULT_RENDERER_CLASSES': (
+        'rest_framework_yaml.renderers.YAMLRenderer',
+    ),
+}
+
    
+
    XML
    
+
    REST Framework XML provides a simple informal XML format. It was previously included directly in the REST framework package, and is now instead supported as a third-party package.
    
+
    Installation & configuration
    
+
    Install using pip.
    
+
    $ pip install djangorestframework-xml
+
    
+
    Modify your REST framework settings.
    
+
    REST_FRAMEWORK = {
+    'DEFAULT_PARSER_CLASSES': (
+        'rest_framework_xml.parsers.XMLParser',
+    ),
+    'DEFAULT_RENDERER_CLASSES': (
+        'rest_framework_xml.renderers.XMLRenderer',
+    ),
+}
+
    
 
    MessagePack
    
 
    MessagePack is a fast, efficient binary serialization format.  Juan Riaza maintains the djangorestframework-msgpack package which provides MessagePack renderer and parser support for REST framework.
    
 
    CamelCase JSON
    
diff --git a/api-guide/permissions/index.html b/api-guide/permissions/index.html
index 7b6f889c6..5e921802f 100644
--- a/api-guide/permissions/index.html
+++ b/api-guide/permissions/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -405,10 +397,6 @@
                       DjangoObjectPermissions
                     
                   
-                    
  • 
-                      TokenHasReadWriteScope
-                    
    • 
-                  
 
                 
 
@@ -575,16 +563,6 @@ def example_view(request, format=None):
 
    
 
    Note: If you need object level view permissions for GET, HEAD and OPTIONS requests, you'll want to consider also adding the DjangoObjectPermissionsFilter class to ensure that list endpoints only return results including objects for which the user has appropriate view permissions.
    
 
    
-
    TokenHasReadWriteScope
    
-
    This permission class is intended for use with either of the OAuthAuthentication and OAuth2Authentication classes, and ties into the scoping that their backends provide.
    
-
    Requests with a safe methods of GET, OPTIONS or HEAD will be allowed if the authenticated token has read permission.
    
-
    Requests for POST, PUT, PATCH and DELETE will be allowed if the authenticated token has write permission.
    
-
    This permission class relies on the implementations of the django-oauth-plus and django-oauth2-provider libraries, which both provide limited support for controlling the scope of access tokens:
    
-
      
-
    • django-oauth-plus: Tokens are associated with a Resource class which has a name, url and is_readonly properties.
      • 
-
    • django-oauth2-provider: Tokens are associated with a bitwise scope attribute, that defaults to providing bitwise values for read and/or write.
      • 
-
    
-
    If you require more advanced scoping for your API, such as restricting tokens to accessing a subset of functionality of your API then you will need to provide a custom permission class.  See the source of the django-oauth-plus or django-oauth2-provider package for more details on scoping token access.
    
 
    
 
    Custom permissions
    
 
    To implement a custom permission, override BasePermission and implement either, or both, of the following methods:
    
diff --git a/api-guide/relations/index.html b/api-guide/relations/index.html
index ee51a7e32..67ecbb4f9 100644
--- a/api-guide/relations/index.html
+++ b/api-guide/relations/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
diff --git a/api-guide/renderers/index.html b/api-guide/renderers/index.html
index 58d6a3cc6..694544fbf 100644
--- a/api-guide/renderers/index.html
+++ b/api-guide/renderers/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -381,22 +373,6 @@
                       JSONRenderer
                     
                   
-                    
  • 
-                      JSONPRenderer
-                    
    • 
-                  
-                    
  • 
-                      YAMLRenderer
-                    
    • 
-                  
-                    
  • 
-                      UnicodeYAMLRenderer
-                    
    • 
-                  
-                    
  • 
-                      XMLRenderer
-                    
    • 
-                  
                     
  • 
                       TemplateHTMLRenderer
                     
    • 
@@ -477,6 +453,18 @@
                   
 
                   
+                    
  • 
+                      YAML
+                    
    • 
+                  
+                    
  • 
+                      XML
+                    
    • 
+                  
+                    
  • 
+                      JSONP
+                    
    • 
+                  
                     
  • 
                       MessagePack
                     
    • 
@@ -527,10 +515,10 @@
 
    The basic process of content negotiation involves examining the request's Accept header, to determine which media types it expects in the response.  Optionally, format suffixes on the URL may be used to explicitly request a particular representation.  For example the URL http://example.com/api/users_count.json might be an endpoint that always returns JSON data.
    
 
    For more information see the documentation on content negotiation.
    
 
    Setting the renderers
    
-
    The default set of renderers may be set globally, using the DEFAULT_RENDERER_CLASSES setting.  For example, the following settings would use YAML as the main media type and also include the self describing API.
    
+
    The default set of renderers may be set globally, using the DEFAULT_RENDERER_CLASSES setting.  For example, the following settings would use JSON as the main media type and also include the self describing API.
    
 
    REST_FRAMEWORK = {
     'DEFAULT_RENDERER_CLASSES': (
-        'rest_framework.renderers.YAMLRenderer',
+        'rest_framework.renderers.JSONRenderer',
         'rest_framework.renderers.BrowsableAPIRenderer',
     )
 }
@@ -538,15 +526,15 @@
 
    You can also set the renderers used for an individual view, or viewset,
 using the APIView class based views.
    
 
    from django.contrib.auth.models import User
-from rest_framework.renderers import JSONRenderer, YAMLRenderer
+from rest_framework.renderers import JSONRenderer
 from rest_framework.response import Response
 from rest_framework.views import APIView
 
 class UserCountView(APIView):
     """
-    A view that returns the count of active users, in JSON or YAML.
+    A view that returns the count of active users in JSON.
     """
-    renderer_classes = (JSONRenderer, YAMLRenderer)
+    renderer_classes = (JSONRenderer, )
 
     def get(self, request, format=None):
         user_count = User.objects.filter(active=True).count()
@@ -555,10 +543,10 @@ class UserCountView(APIView):
 
    
 
    Or, if you're using the @api_view decorator with function based views.
    
 
    @api_view(['GET'])
-@renderer_classes((JSONRenderer, JSONPRenderer))
+@renderer_classes((JSONRenderer,))
 def user_count_view(request, format=None):
     """
-    A view that returns the count of active users, in JSON or JSONp.
+    A view that returns the count of active users in JSON.
     """
     user_count = User.objects.filter(active=True).count()
     content = {'user_count': user_count}
@@ -585,41 +573,6 @@ def user_count_view(request, format=None):
 
    .media_type: application/json
    
 
    .format: '.json'
    
 
    .charset: None
    
-
    JSONPRenderer
    
-
    Renders the request data into JSONP.  The JSONP media type provides a mechanism of allowing cross-domain AJAX requests, by wrapping a JSON response in a javascript callback.
    
-
    The javascript callback function must be set by the client including a callback URL query parameter.  For example http://example.com/api/users?callback=jsonpCallback.  If the callback function is not explicitly set by the client it will default to 'callback'.
    
-
    
-
    Warning: If you require cross-domain AJAX requests, you should almost certainly be using the more modern approach of CORS as an alternative to JSONP.  See the CORS documentation for more details.
    
-
    The jsonp approach is essentially a browser hack, and is only appropriate for globally  readable API endpoints, where GET requests are unauthenticated and do not require any user permissions.
    
-
    
-
    .media_type: application/javascript
    
-
    .format: '.jsonp'
    
-
    .charset: utf-8
    
-
    YAMLRenderer
    
-
    Renders the request data into YAML.
    
-
    Requires the pyyaml package to be installed.
    
-
    Note that non-ascii characters will be rendered using \uXXXX character escape.  For example:
    
-
    unicode black star: "\u2605"
-
    
-
    .media_type: application/yaml
    
-
    .format: '.yaml'
    
-
    .charset: utf-8
    
-
    UnicodeYAMLRenderer
    
-
    Renders the request data into YAML.
    
-
    Requires the pyyaml package to be installed.
    
-
    Note that non-ascii characters will not be character escaped.  For example:
    
-
    unicode black star: ★
-
    
-
    .media_type: application/yaml
    
-
    .format: '.yaml'
    
-
    .charset: utf-8
    
-
    XMLRenderer
    
-
    Renders REST framework's default style of XML response content.
    
-
    Note that the XML markup language is used typically used as the base language for more strictly defined domain-specific languages, such as RSS, Atom, and XHTML.
    
-
    If you are considering using XML for your API, you may want to consider implementing a custom renderer and parser for your specific requirements, and using an existing domain-specific media-type, or creating your own custom XML-based media-type.
    
-
    .media_type: application/xml
    
-
    .format: '.xml'
    
-
    .charset: utf-8
    
 
    TemplateHTMLRenderer
    
 
    Renders data to HTML, using Django's standard template rendering.
 Unlike other renderers, the data passed to the Response does not need to be serialized.  Also, unlike other renderers, you may want to include a template_name argument when creating the Response.
    
@@ -791,10 +744,59 @@ In this case you can underspecify the media types it should respond to, by using
 
    
 
    Third party packages
    
 
    The following third party packages are also available.
    
+
    YAML
    
+
    REST framework YAML provides YAML parsing and rendering support. It was previously included directly in the REST framework package, and is now instead supported as a third-party package.
    
+
    Installation & configuration
    
+
    Install using pip.
    
+
    $ pip install djangorestframework-yaml
+
    
+
    Modify your REST framework settings.
    
+
    REST_FRAMEWORK = {
+    'DEFAULT_PARSER_CLASSES': (
+        'rest_framework_yaml.parsers.YAMLParser',
+    ),
+    'DEFAULT_RENDERER_CLASSES': (
+        'rest_framework_yaml.renderers.YAMLRenderer',
+    ),
+}
+
    
+
    XML
    
+
    REST Framework XML provides a simple informal XML format. It was previously included directly in the REST framework package, and is now instead supported as a third-party package.
    
+
    Installation & configuration
    
+
    Install using pip.
    
+
    $ pip install djangorestframework-xml
+
    
+
    Modify your REST framework settings.
    
+
    REST_FRAMEWORK = {
+    'DEFAULT_PARSER_CLASSES': (
+        'rest_framework_xml.parsers.XMLParser',
+    ),
+    'DEFAULT_RENDERER_CLASSES': (
+        'rest_framework_xml.renderers.XMLRenderer',
+    ),
+}
+
    
+
    JSONP
    
+
    REST framework JSONP provides JSONP rendering support. It was previously included directly in the REST framework package, and is now instead supported as a third-party package.
    
+
    
+
    Warning: If you require cross-domain AJAX requests, you should generally be using the more modern approach of CORS as an alternative to JSONP. See the CORS documentation for more details.
    
+
    The jsonp approach is essentially a browser hack, and is only appropriate for globally readable API endpoints, where GET requests are unauthenticated and do not require any user permissions.
    
+
    
+
    Installation & configuration
    
+
    Install using pip.
    
+
    $ pip install djangorestframework-jsonp
+
    
+
    Modify your REST framework settings.
    
+
    REST_FRAMEWORK = {
+    'DEFAULT_RENDERER_CLASSES': (
+        'rest_framework_yaml.renderers.JSONPRenderer',
+    ),
+}
+
    
 
    MessagePack
    
 
    MessagePack is a fast, efficient binary serialization format.  Juan Riaza maintains the djangorestframework-msgpack package which provides MessagePack renderer and parser support for REST framework.
    
 
    CSV
    
-
    Comma-separated values are a plain-text tabular data format, that can be easily imported into spreadsheet applications.  Mjumbe Poe maintains the djangorestframework-csv package which provides CSV renderer support for REST framework.
    
+
    Comma-separated values are a plain-text tabular data format, that can be easily imported into spreadsheet applications. Mjumbe Poe maintains the djangorestframework-csv package which provides CSV renderer support for REST framework.
    
 
    UltraJSON
    
 
    UltraJSON is an optimized C JSON encoder which can give significantly faster JSON rendering. Jacob Haslehurst maintains the drf-ujson-renderer package which implements JSON rendering using the UJSON package.
    
 
    CamelCase JSON
    
diff --git a/api-guide/requests/index.html b/api-guide/requests/index.html
index 4cc5fd3d3..3db6d3805 100644
--- a/api-guide/requests/index.html
+++ b/api-guide/requests/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -492,7 +484,7 @@
 
    request.query_params is a more correctly named synonym for request.GET.
    
 
    For clarity inside your code, we recommend using request.query_params instead of the Django's standard request.GET. Doing so will help keep your codebase more correct and obvious - any HTTP method type may include query parameters, not just GET requests.
    
 
    .DATA and .FILES
    
-
    The old-style version 2.x request.data and request.FILES attributes are still available, but are now pending deprecation in favor of the unified request.data attribute.
    
+
    The old-style version 2.x request.DATA and request.FILES attributes are still available, but are now pending deprecation in favor of the unified request.data attribute.
    
 
    .QUERY_PARAMS
    
 
    The old-style version 2.x request.QUERY_PARAMS attribute is still available, but is now pending deprecation in favor of the more pythonic request.query_params.
    
 
    .parsers
    
diff --git a/api-guide/responses/index.html b/api-guide/responses/index.html
index 43b75ade3..4588b623d 100644
--- a/api-guide/responses/index.html
+++ b/api-guide/responses/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
diff --git a/api-guide/reverse/index.html b/api-guide/reverse/index.html
index b716060d5..c0d42c329 100644
--- a/api-guide/reverse/index.html
+++ b/api-guide/reverse/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
diff --git a/api-guide/routers/index.html b/api-guide/routers/index.html
index 80bf512da..33a225fc3 100644
--- a/api-guide/routers/index.html
+++ b/api-guide/routers/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
diff --git a/api-guide/serializers/index.html b/api-guide/serializers/index.html
index 4bb06d3ba..b5b732137 100644
--- a/api-guide/serializers/index.html
+++ b/api-guide/serializers/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -414,7 +406,7 @@
                     
                   
                     
  • 
-                      Specifying which fields should be included
+                      Specifying which fields to include
                     
    • 
                   
                     
  • 
@@ -426,11 +418,11 @@
                     
    • 
                   
                     
  • 
-                      Specifying which fields should be read-only
+                      Specifying read only fields
                     
    • 
                   
                     
  • 
-                      Specifying additional keyword arguments for fields.
+                      Additional keyword arguments
                     
    • 
                   
                     
  • 
@@ -441,6 +433,10 @@
                       Inheritance of the 'Meta' class
                     
    • 
                   
+                    
  • 
+                      Customizing field mappings
+                    
    • 
+                  
 
                 
 
@@ -920,7 +916,7 @@ AccountSerializer():
     name = CharField(allow_blank=True, max_length=100, required=False)
     owner = PrimaryKeyRelatedField(queryset=User.objects.all())
 
    
-
    Specifying which fields should be included
    
+
    Specifying which fields to include
    
 
    If you only want a subset of the default fields to be used in a model serializer, you can do so using fields or exclude options, just as you would with a ModelForm.
    
 
    For example:
    
 
    class AccountSerializer(serializers.ModelSerializer):
@@ -950,7 +946,7 @@ AccountSerializer():
         model = Account
 
    
 
    Extra fields can correspond to any property or callable on the model.
    
-
    Specifying which fields should be read-only
    
+
    Specifying read only fields
    
 
    You may wish to specify multiple fields as read-only. Instead of adding each field explicitly with the read_only=True attribute, you may use the shortcut Meta option, read_only_fields.
    
 
    This option should be a list or tuple of field names, and is declared as follows:
    
 
    class AccountSerializer(serializers.ModelSerializer):
@@ -968,7 +964,7 @@ AccountSerializer():
 
    
 
    Please review the Validators Documentation for details on the UniqueTogetherValidator and CurrentUserDefault classes.
    
 
    
-
    Specifying additional keyword arguments for fields.
    
+
    Additional keyword arguments
    
 
    There is also a shortcut allowing you to specify arbitrary additional keyword arguments on fields, using the extra_kwargs option. Similarly to read_only_fields this means you do not need to explicitly declare the field on the serializer.
    
 
    This option is a dictionary, mapping field names to a dictionary of keyword arguments. For example:
    
 
    class CreateUserSerializer(serializers.ModelSerializer):
@@ -997,6 +993,43 @@ AccountSerializer():
         model = Account
 
    
 
    Typically we would recommend not using inheritance on inner Meta classes, but instead declaring all options explicitly.
    
+
    Customizing field mappings
    
+
    The ModelSerializer class also exposes an API that you can override in order to alter how serializer fields are automatically determined when instantiating the serializer.
    
+
    Normally if a ModelSerializer does not generate the fields you need by default the you should either add them to the class explicitly, or simply use a regular Serializer class instead. However in some cases you may want to create a new base class that defines how the serializer fields are created for any given model.
    
+
    .serializer_field_mapping
    
+
    A mapping of Django model classes to REST framework serializer classes. You can override this mapping to alter the default serializer classes that should be used for each model class.
    
+
+
    This property should be the serializer field class, that is used for relational fields by default.
    
+
    For ModelSerializer this defaults to PrimaryKeyRelatedField.
    
+
    For HyperlinkedModelSerializer this defaults to serializers.HyperlinkedRelatedField.
    
+
    serializer_url_field
    
+
    The serializer field class that should be used for any url field on the serializer.
    
+
    Defaults to serializers.HyperlinkedIdentityField
    
+
    serializer_choice_field
    
+
    The serializer field class that should be used for any choice fields on the serializer.
    
+
    Defaults to serializers.ChoiceField
    
+
    The field_class and field_kwargs API
    
+
    The following methods are called to determine the class and keyword arguments for each field that should be automatically included on the serializer. Each of these methods should return a two tuple of (field_class, field_kwargs).
    
+
    .build_standard_field(self, field_name, model_field)
    
+
    Called to generate a serializer field that maps to a standard model field.
    
+
    The default implementation returns a serializer class based on the serializer_field_mapping attribute.
    
+
    .build_relational_field(self, field_name, relation_info)
    
+
    Called to generate a serializer field that maps to a relational model field.
    
+
    The default implementation returns a serializer class based on the serializer_relational_field attribute.
    
+
    The relation_info argument is a named tuple, that contains model_field, related_model, to_many and has_through_model properties.
    
+
    .build_nested_field(self, field_name, relation_info, nested_depth)
    
+
    Called to generate a serializer field that maps to a relational model field, when the depth option has been set.
    
+
    The default implementation dynamically creates a nested serializer class based on either ModelSerializer or HyperlinkedModelSerializer.
    
+
    The nested_depth will be the value of the depth option, minus one.
    
+
    The relation_info argument is a named tuple, that contains model_field, related_model, to_many and has_through_model properties.
    
+
    .build_property_field(self, field_name, model_class)
    
+
    Called to generate a serializer field that maps to a property or zero-argument method on the model class.
    
+
    The default implementation returns a ReadOnlyField class.
    
+
    .build_url_field(self, field_name, model_class)
    
+
    Called to generate a serializer field for the serializer's own url field. The default implementation returns a HyperlinkedIdentityField class.
    
+
    .build_unknown_field(self, field_name, model_class)
    
+
    Called when the field name did not map to any model field or model property.
+The default implementation raises an error, although subclasses may customize this behavior.
    
 
    
 
    HyperlinkedModelSerializer
    
 
    The HyperlinkedModelSerializer class is similar to the ModelSerializer class except that it uses hyperlinks to represent relationships, rather than primary keys.
    
diff --git a/api-guide/settings/index.html b/api-guide/settings/index.html
index f3062be62..ac100eb4e 100644
--- a/api-guide/settings/index.html
+++ b/api-guide/settings/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -377,6 +369,10 @@
                       Generic view settings
                     
                   
+                    
  • 
+                      Versioning settings
+                    
    • 
+                  
                     
  • 
                       Authentication settings
                     
    • 
@@ -433,10 +429,10 @@
 
    For example your project's settings.py file might include something like this:
    
 
    REST_FRAMEWORK = {
     'DEFAULT_RENDERER_CLASSES': (
-        'rest_framework.renderers.YAMLRenderer',
+        'rest_framework.renderers.JSONRenderer',
     ),
     'DEFAULT_PARSER_CLASSES': (
-        'rest_framework.parsers.YAMLParser',
+        'rest_framework.parsers.JSONParser',
     )
 }
 
    
@@ -534,6 +530,17 @@ If set to None then generic filtering is disabled.
    
 
    The name of a query parameter, which can be used to specify the ordering of results returned by OrderingFilter.
    
 
    Default: ordering
    
 
    
+
    Versioning settings
    
+
    DEFAULT_VERSION
    
+
    The value that should be used for request.version when no versioning information is present.
    
+
    Default: None
    
+
    ALLOWED_VERSIONS
    
+
    If set, this value will restrict the set of versions that may be returned by the versioning scheme, and will raise an error if the provided version if not in this set.
    
+
    Default: None
    
+
    VERSION_PARAMETER
    
+
    The string that should used for any versioning parameters, such as in the media type or URL query parameters.
    
+
    Default: 'version'
    
+
    
 
    Authentication settings
    
 
    The following settings control the behavior of unauthenticated requests.
    
 
    UNAUTHENTICATED_USER
    
@@ -661,7 +668,7 @@ If set to None then generic filtering is disabled.
    
 
    A string representing the function that should be used when returning a response for any given exception.  If the function returns None, a 500 error will be raised.
    
 
    This setting can be changed to support error responses other than the default {"detail": "Failure..."} responses.  For example, you can use it to provide API responses like {"errors": [{"message": "Failure...", "code": ""} ...]}.
    
 
    This should be a function with the following signature:
    
-
    exception_handler(exc)
+
    exception_handler(exc, context)
 
    
 
               
                
diff --git a/api-guide/testing/index.html b/api-guide/testing/index.html
index 650fc53ee..194075510 100644
--- a/api-guide/testing/index.html
+++ b/api-guide/testing/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -469,7 +461,7 @@
 
    APIRequestFactory
    
 
    Extends Django's existing RequestFactory class.
    
 
    Creating test requests
    
-
    The APIRequestFactory class supports an almost identical API to Django's standard RequestFactory class.  This means the that standard .get(), .post(), .put(), .patch(), .delete(), .head() and .options() methods are all available.
    
+
    The APIRequestFactory class supports an almost identical API to Django's standard RequestFactory class.  This means that the standard .get(), .post(), .put(), .patch(), .delete(), .head() and .options() methods are all available.
    
 
    from rest_framework.test import APIRequestFactory
 
 # Using the standard RequestFactory API to create a form POST request
@@ -506,7 +498,9 @@ request = factory.put('/notes/547/', content, content_type=content_type)
 
    Forcing authentication
    
 
    When testing views directly using a request factory, it's often convenient to be able to directly authenticate the request, rather than having to construct the correct authentication credentials.
    
 
    To forcibly authenticate a request, use the force_authenticate() method.
    
-
    factory = APIRequestFactory()
+
    from rest_framework.tests import force_authenticate
+
+factory = APIRequestFactory()
 user = User.objects.get(username='olivia')
 view = AccountDetail.as_view()
 
@@ -538,9 +532,9 @@ response = view(request)
 
    Note: It's worth noting that Django's standard RequestFactory doesn't need to include this option, because when using regular Django the CSRF validation takes place in middleware, which is not run when testing views directly.  When using REST framework, CSRF validation takes place inside the view, so the request factory needs to disable view-level CSRF checks.
    
 
    
 
    APIClient
    
-
    Extends Django's existing Client class.
    
+
    Extends Django's existing Client class.
    
 
    Making requests
    
-
    The APIClient class supports the same request interface as APIRequestFactory.  This means the that standard .get(), .post(), .put(), .patch(), .delete(), .head() and .options() methods are all available.  For example:
    
+
    The APIClient class supports the same request interface as Django's standard Client class.  This means the that standard .get(), .post(), .put(), .patch(), .delete(), .head() and .options() methods are all available.  For example:
    
 
    from rest_framework.test import APIClient
 
 client = APIClient()
@@ -646,13 +640,13 @@ self.assertEqual(response.content, '{"username": "lauren", "id": 4}')
 
    
 
    Setting the available formats
    
 
    If you need to test requests using something other than multipart or json requests, you can do so by setting the TEST_REQUEST_RENDERER_CLASSES setting.
    
-
    For example, to add support for using format='yaml' in test requests, you might have something like this in your settings.py file.
    
+
    For example, to add support for using format='html' in test requests, you might have something like this in your settings.py file.
    
 
    REST_FRAMEWORK = {
     ...
     'TEST_REQUEST_RENDERER_CLASSES': (
         'rest_framework.renderers.MultiPartRenderer',
         'rest_framework.renderers.JSONRenderer',
-        'rest_framework.renderers.YAMLRenderer'
+        'rest_framework.renderers.TemplateHTMLRenderer'
     )
 }
 
    
diff --git a/api-guide/throttling/index.html b/api-guide/throttling/index.html
index 7db58e4c1..6d65c9484 100644
--- a/api-guide/throttling/index.html
+++ b/api-guide/throttling/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
diff --git a/api-guide/validators/index.html b/api-guide/validators/index.html
index 525cea8a5..395fd9de1 100644
--- a/api-guide/validators/index.html
+++ b/api-guide/validators/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
diff --git a/api-guide/versioning/index.html b/api-guide/versioning/index.html
new file mode 100644
index 000000000..8a29d0eae
--- /dev/null
+++ b/api-guide/versioning/index.html
@@ -0,0 +1,612 @@
+
+
+
+
+  
+  
+  Versioning - Django REST framework
+  
+  
+  
+  
+  
+
+  
+  
+  
+  
+  
+
+  
+  
+
+  
+
+  
+
+
+
+  
    
+
+        
    
+      
    
+        
    
+          GitHub
+          
+          
+           Search
+          
+            
+            
+            
+          
+          Django REST framework
+          
    
+            
+            
+            
+            
+          
    
+          
+
+        
    
+      
    
+    
    
+
+    
    
+      
    
+
+        
+        
+
+        
    
+
+          
    
+            
+            
+          
    
+
+          
    
+            
+              
+                
+                  versioning.py
+                
+              
+            
+
+            
    Versioning
    
+
    
+
    Versioning an interface is just a "polite" way to kill deployed clients.
    
+
    — Roy Fielding.
    
+
    
+
    API versioning allows you to alter behavior between different clients. REST framework provides for a number of different versioning schemes.
    
+
    Versioning is determined by the incoming client request, and may either be based on the request URL, or based on the request headers.
    
+
    There are a number of valid approaches to approaching versioning. Non-versioned systems can also be appropriate, particularly if you're engineering for very long-term systems with multiple clients outside of your control.
    
+
    Versioning with REST framework
    
+
    When API versioning is enabled, the request.version attribute will contain a string that corresponds to the version requested in the incoming client request.
    
+
    By default, versioning is not enabled, and request.version will always return None.
    
+
    Varying behavior based on the version
    
+
    How you vary the API behavior is up to you, but one example you might typically want is to switch to a different serialization style in a newer version. For example:
    
+
    def get_serializer_class(self):
+    if self.request.version == 'v1':
+        return AccountSerializerVersion1
+    return AccountSerializer
+
    
+
    Reversing URLs for versioned APIs
    
+
    The reverse function included by REST framework ties in with the versioning scheme. You need to make sure to include the current request as a keyword argument, like so.
    
+
    reverse('bookings-list', request=request)
+
    
+
    The above function will apply any URL transformations appropriate to the request version. For example:
    
+
      
+
    • If NamespacedVersioning was being used, and the API version was 'v1', then the URL lookup used would be 'v1:bookings-list', which might resolve to a URL like http://example.org/v1/bookings/.
      • 
+
    • If QueryParameterVersioning was being used, and the API version was 1.0, then the returned URL might be something like http://example.org/bookings/?version=1.0
      • 
+
    
+
    Versioned APIs and hyperlinked serializers
    
+
    When using hyperlinked serialization styles together with a URL based versioning scheme make sure to include the request as context to the serializer.
    
+
    def get(self, request):
+    queryset = Booking.objects.all()
+    serializer = BookingsSerializer(queryset, many=True, context={'request': request})
+    return Response({'all_bookings': serializer.data})
+
    
+
    Doing so will allow any returned URLs to include the appropriate versioning.
    
+
    Configuring the versioning scheme
    
+
    The versioning scheme is defined by the DEFAULT_VERSIONING_CLASS settings key.
    
+
    REST_FRAMEWORK = {
+    'DEFAULT_VERSIONING_CLASS': 'rest_framework.versioning.NamespaceVersioning'
+}
+
    
+
    Unless it is explicitly set, the value for DEFAULT_VERSIONING_CLASS will be None. In this case the request.version attribute will always return None.
    
+
    You can also set the versioning scheme on an individual view. Typically you won't need to do this, as it makes more sense to have a single versioning scheme used globally. If you do need to do so, use the versioning_class attribute.
    
+
    class ProfileList(APIView):
+    versioning_class = versioning.QueryParameterVersioning
+
    
+
    Other versioning settings
    
+
    The following settings keys are also used to control versioning:
    
+
      
+
    • DEFAULT_VERSION. The value that should be used for request.version when no versioning information is present. Defaults to None.
      • 
+
    • ALLOWED_VERSIONS. If set, this value will restrict the set of versions that may be returned by the versioning scheme, and will raise an error if the provided version if not in this set. Defaults to None.
      • 
+
    • VERSION_PARAMETER. The string that should used for any versioning parameters, such as in the media type or URL query parameters. Defaults to 'version'.
      • 
+
    
+
    
+
    API Reference
    
+
    AcceptHeaderVersioning
    
+
    This scheme requires the client to specify the version as part of the media type in the Accept header. The version is included as a media type parameter, that supplements the main media type.
    
+
    Here's an example HTTP request using the accept header versioning style.
    
+
    GET /bookings/ HTTP/1.1
+Host: example.com
+Accept: application/json; version=1.0
+
    
+
    In the example request above request.version attribute would return the string '1.0'.
    
+
    Versioning based on accept headers is generally considered as best practice, although other styles may be suitable depending on your client requirements.
    
+
    Using accept headers with vendor media types
    
+
    Strictly speaking the json media type is not specified as including additional parameters. If you are building a well-specified public API you might consider using a vendor media type. To do so, configure your renderers to use a JSON based renderer with a custom media type:
    
+
    class BookingsAPIRenderer(JSONRenderer):
+    media_type = 'application/vnd.megacorp.bookings+json'
+
    
+
    Your client requests would now look like this:
    
+
    GET /bookings/ HTTP/1.1
+Host: example.com
+Accept: application/vnd.megacorp.bookings+json; version=1.0
+
    
+
    URLParameterVersioning
    
+
    This scheme requires the client to specify the version as part of the URL path.
    
+
    GET /v1/bookings/ HTTP/1.1
+Host: example.com
+Accept: application/json
+
    
+
    Your URL conf must include a pattern that matches the version with a 'version' keyword argument, so that this information is available to the versioning scheme.
    
+
    urlpatterns = [
+    url(
+        r'^(?P<version>{v1,v2})/bookings/$',
+        bookings_list,
+        name='bookings-list'
+    ),
+    url(
+        r'^(?P<version>{v1,v2})/bookings/(?P<pk>[0-9]+)/$',
+        bookings_detail,
+        name='bookings-detail'
+    )
+]
+
    
+
    NamespaceVersioning
    
+
    To the client, this scheme is the same as URLParameterVersioning. The only difference is how it is configured in your Django application, as it uses URL namespacing, instead of URL keyword arguments.
    
+
    GET /v1/something/ HTTP/1.1
+Host: example.com
+Accept: application/json
+
    
+
    With this scheme the request.version attribute is determined based on the namespace that matches the incoming request path.
    
+
    In the following example we're giving a set of views two different possible URL prefixes, each under a different namespace:
    
+
    # bookings/urls.py
+urlpatterns = [
+    url(r'^$', bookings_list, name='bookings-list'),
+    url(r'^(?P<pk>[0-9]+)/$', bookings_detail, name='bookings-detail')
+]
+
+# urls.py
+urlpatterns = [
+    url(r'^v1/bookings/', include('bookings.urls', namespace='v1')),
+    url(r'^v2/bookings/', include('bookings.urls', namespace='v2'))
+]
+
    
+
    Both URLParameterVersioning and NamespaceVersioning are reasonable if you just need a simple versioning scheme. The URLParameterVersioning approach might be better suitable for small ad-hoc projects, and the NamespaceVersioning is probably easier to manage for larger projects.
    
+
    HostNameVersioning
    
+
    The hostname versioning scheme requires the client to specify the requested version as part of the hostname in the URL.
    
+
    For example the following is an HTTP request to the http://v1.example.com/bookings/ URL:
    
+
    GET /bookings/ HTTP/1.1
+Host: v1.example.com
+Accept: application/json
+
    
+
    By default this implementation expects the hostname to match this simple regular expression:
    
+
    ^([a-zA-Z0-9]+)\.[a-zA-Z0-9]+\.[a-zA-Z0-9]+$
+
    
+
    Note that the first group is enclosed in brackets, indicating that this is the matched portion of the hostname.
    
+
    The HostNameVersioning scheme can be awkward to use in debug mode as you will typically be accessing a raw IP address such as 127.0.0.1. There are various online services which you to access localhost with a custom subdomain which you may find helpful in this case.
    
+
    Hostname based versioning can be particularly useful if you have requirements to route incoming requests to different servers based on the version, as you can configure different DNS records for different API versions.
    
+
    QueryParameterVersioning
    
+
    This scheme is a simple style that includes the version as a query parameter in the URL. For example:
    
+
    GET /something/?version=0.1 HTTP/1.1
+Host: example.com
+Accept: application/json
+
    
+
    
+
    Custom versioning schemes
    
+
    To implement a custom versioning scheme, subclass BaseVersioning and override the .determine_version method.
    
+
    Example
    
+
    The following example uses a custom X-API-Version header to determine the requested version.
    
+
    class XAPIVersionScheme(versioning.BaseVersioning):
+    def determine_version(self, request, *args, **kwargs):
+        return request.META.get('HTTP_X_API_VERSION', None)
+
    
+
    If your versioning scheme is based on the request URL, you will also want to alter how versioned URLs are determined. In order to do so you should override the .reverse() method on the class. See the source code for examples.
    
+
+          
    
+          
+        
    
+        
+      
    
+      
+    
    
+    
+    
    
+  
    
+  
+
+  
    
+    
    Documentation built with MkDocs.
+    
    
+  
    
+
+  
+  
+  
+  
+  
+  
+
+  
+
+
+
\ No newline at end of file
diff --git a/api-guide/views/index.html b/api-guide/views/index.html
index f07a4921a..09a1de417 100644
--- a/api-guide/views/index.html
+++ b/api-guide/views/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
diff --git a/api-guide/viewsets/index.html b/api-guide/viewsets/index.html
index 7029dc8d9..954f49eb7 100644
--- a/api-guide/viewsets/index.html
+++ b/api-guide/viewsets/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -566,7 +558,7 @@ class UserViewSet(viewsets.ModelViewSet):
 
    The ModelViewSet class inherits from GenericAPIView and includes implementations for various actions, by mixing in the behavior of the various mixin classes.
    
 
    The actions provided by the ModelViewSet class are .list(), .retrieve(),  .create(), .update(), and .destroy().
    
 
    Example
    
-
    Because ModelViewSet extends GenericAPIView, you'll normally need to provide at least the queryset and serializer_class attributes, or the model attribute shortcut.  For example:
    
+
    Because ModelViewSet extends GenericAPIView, you'll normally need to provide at least the queryset and serializer_class attributes.  For example:
    
 
    class AccountViewSet(viewsets.ModelViewSet):
     """
     A simple ViewSet for viewing and editing accounts.
diff --git a/css/default.css b/css/default.css
index 8c9cd5363..d998fbeed 100644
--- a/css/default.css
+++ b/css/default.css
@@ -171,6 +171,25 @@ body{
   background-attachment: fixed;
 }
 
+
+#main-content h1:first-of-type {
+    margin-top: 0
+}
+
+#main-content h1, #main-content h2 {
+    font-weight: 300;
+    margin-top: 20px
+}
+
+#main-content h3, #main-content h4, #main-content h5 {
+    font-weight: 500;
+    margin-top: 15px
+}
+
+#main-content img {
+    display: block;
+    margin: 40px auto;
+}
 /* custom navigation styles */
 
 .navbar .navbar-inner{
@@ -239,6 +258,10 @@ body a:hover{
      }
 }
 
+h1 code, h2 code, h3 code, h4 code, h5 code {
+  color: #333;
+}
+
 /* sticky footer and footer */
 html, body {
   height: 100%;
diff --git a/img/.DS_Store b/img/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..fe0502b95824dbd7de4922a894a7087faa262cb2
GIT binary patch
literal 15364
zcmeHMU2GIZ9RL4Ifj!uxTM85kB?p&Cl|l*#Qb4&Lr7d4lX`wA&W$$)d7WQ_}-MuTd
z7K$2!Mu=YzMq?DCJ|Mvt6@2hTW5j?@Hb#jb59*6CN+OBM3;t(zuOD~UCqqJXrrG(=
z&i`X(e)F5@&Kv+>Jfp1uhyZ{@50i>aS&_u_>?uekLCp-3Nd5p0^uuyUg9W_>)}lfn
zAP^7;2m}NI0)aaL0s5cKk~H0yA{Ph<1Ox&j2(bMjLJyO%Ko0qmZyl8JBLK-#s^*Ex
zbPnJ?kwC@*Ipj<3N-_P@0|u@b95K*$Cw+vOlZ*v&$d|r5pzjVCw2Z+C1$pb_7vbiB
zF<**YARrJZM1Y;$r-4dmc7yUU=l3n9olKZ^g7j=jHPKUZizg}p$dCk`>@#4JRO!SY
zocqW7;jTQtO3>g4x9gvA2l1ZhLr%aVX
zAxYlfVOW~o7q>H(=I(1dZ1=Spnx0Ud1HA01UdD~94%f7*-eJ=4a=UGtRNfz0cNm&?
zxLc_l7^q)c8(Fcsey}z&P``3jZDjSTy1~JaB!v`^W-ng8p`~3Ncy#di2}T?0eXxN;
z*nc0%Pg1F1G@6?<6Vx!XDo`59Y%o;(B{$R`6lG+v)27Se8D&cO%!*mF=Ty#}S2ce@
z^}^~%w^ET%lSg|UhQKDA*V(OanTCtfBYq
zOfxfgkM6i63;a6|m}){dcUp1V^XycY>Nu*^tH=A9C5uJ_X?1iKiMQ02R+EO+8{K%_
z$2uBgi<(k2RudF*Dg{QZd=;}gJ(riGxf)5qk#eZrQd4>;8l%fZo+MZb4X_p3;4m$w
zGw?E;hfDA&T!UZXCYItHT#QTcUc4WhumvB&y_iH3Q)uHc?8oC6(4-_slSR2!eTk$=RDZl)LhvjPl)h%+`5(Wq-rKJrt0Yprpeggb|h^xld{}`
z`RE$Mn7pa(-0RwoN4y}%5rTCqO2*Z9=@i_^>W$Qdt6)evS2nkL(OpaHR@Xl;%s4C0
zmMc55hHE5DeRm&QZC$FH)GdwXaxbk|%QJcm-3gUrtv?CF73DLPc~xO~zeX{4*c#Jo
z%KK7?YZg|8!~2+KlcQ6vNfNJK91Y9uE)7so1H&aXvfO@@HVMTI`L4Cgej6fhYzx5x2vwVGp$?HrOVXz##lo|xGLN@
z(GVr6i+MF@nyy7-PyEHFf0VH~RzzcUelbL>sD_o$2%T_~+i^RZB
z;3^Cg3x9&&;X3>QH{fq9!7?nznOK1fumAgrDJM{2af;Z}DgR4gd7JHp1ntxnBDc
z*`SJXIoQ=oUYvl-P0cNHw%o~F{$_O7<&<8xanlGd^2jijlAMP=(KrEf1mko>vc&Z=EUmrPADO1_%khnDwJ*-Had(3%B4ZW7o>hQI-%fhlUiLU{sW%O1ibGEbB
zHTTJ~Qp(o@dtJYQv{N|k7gWukCoh!aA^LB}o0(n{mL=K`|2<=`5MO^Jw%&l7a0{oR
zjPq#ktik2P(HO>wp-tF~t+)%@aX0QEj;gemYN(@yX=18NTpc8)p2WxSaeM~P;IsG~
zK98^9tN0qej%V>4zJurS0x|azeuy9A6&%Lz@;JLKkF(zw<7~Fgu}s@yKl-qJyPQ5?
z*auaXK7L&OY3K2enhd=a|E&3fyq+BMaYnBq2?PWJ0s(=*?LuIZA2`D9|2I$k`~U4~
zUc?m$2n6l`1hBNRtuam=$(_0L`^4_rBlH}ihb3k=4&i~^4|Gzr_v-KyEKtLcM5D*9m1Ox&C0fB%(
ZKp-Fx5C{ka1Ofs9fq+0jAn@Nr;2))yqdout

literal 0
HcmV?d00001

diff --git a/img/cursor-pagination.png b/img/cursor-pagination.png
new file mode 100644
index 0000000000000000000000000000000000000000..1c9c99b684564b1c4af278f96f0e016de8a28ca9
GIT binary patch
literal 12221
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
    FdM1>*;W0Ix=Z$X}_;J
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
Hu0mjfzM=e`

literal 0
HcmV?d00001

diff --git a/img/pages-pagination.png b/img/pages-pagination.png
new file mode 100644
index 0000000000000000000000000000000000000000..4ce1a09a837fdf59dc087fac697514eda7d49003
GIT binary patch
literal 10229
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
DtsoG7

literal 0
HcmV?d00001

diff --git a/img/sponsors/.DS_Store b/img/sponsors/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..6f3ecd65b779d0e9b09c64996119260276b474de
GIT binary patch
literal 15364
zcmeHNy>c8y5biz6Ajz^MBV(XQj)ZbxQ#O8qE0?K)hybccpv3*_(EYJ@r;{8hp~!dw
zA`;$!M<5{OA$SA=0`q;{d-k+%=Bh{ti@{vs0^Jl|JyEUA&fPlE-SCJdvKi30yE~SZQqEFWT#`j;ocv9pQ8}V&EG6R``
z%s^%!Gw^yaz_l00PF@R*ht#Ogd=Oc7h#;
zf2+b@$cgS?jDQ}i4sHCOaT#Qn<~8}L)bjR-bqxRvK6At
z<`(1(u#0mFZHMsBB!ySbLcHnQt}N|BGGmGRK|Q~7QzKg;@~-OJhU5v@nN@Mofd(ad
zYs(oJDC1UeZ^!j@sD1UI`$8@tn;gvH!8iwqu{VENW3I1k_f-GL&J&q)sC|`5OP|5&
zCTxyMBV!I{e&RmYP)AY}MYbI3eU(Pf&JkU0py}fU{v%5kZ>9Fv#+^j8(T3tMu>82{
zb&Oc!J|0=?R{eMIDXtsXce)w-1J!4S7@}T7{6*1>+nsL$9c+XTpmPcVtsTO&rjL87
z?Hn?xH9a^=X-z-4UQBCxj*&Kl){MH8&G3gqTilQF{1nm|aT{jC2$CbL3&y*M(u7Ph
zwfk7L9$#Epc`*9yt~{vvY2=w*+y05H-#o^WQn*dnk2x>^=ftd_qAtL2_N0>1qp-@g;Xs+_q^A}3>R;&OpQm2`$YfHgUFWX?Q~>&bk|
zt?H&Ht3sYp+n5Qs-wEuiL}rbw{O2i6nLRq3Y0BECM9w*cmMzscDplg=Syjf&0Ta^5y+hir7Iz}(?*xi*
zvegLqvRy5rF2Oq4q3o!AWXEA`|E(k6K_Y)Wlfco_4rjlaVV%qBmljTtXS2StOgk!_
zOu1f6I%{UuWgJ^^9C&g#v)HOC?zJ?LUvJpQ+xjP9%RFk>gtf|2h`FsEJ%f(?O%P{}
zapj@J{)X}u_Fx)QQ;TEP&WZ7$EQQ!RDxEyrz8EV)`sxHWZ@>K-JwHez^ZrZ
zZ0slYIp{qnb%o~K%inWttSad_hc;_DBIz?$k%_1w-wt_KwJyO>S3R~wTf%22I{%a!
zw~4*F+SjOUe-4;?Tl-=~Y<$~{$`NOKKCCdKT+(|Ht&9h*5R9Np=(L)z%*JS6^o!e1
z->tObJP=2~7XhOB4ISe022LFJ`2PPBqydTF|LH^dk{QShTu%my?WbQneFEF6ck63b
z@?Co!=eIal2cFf(anV=tX!TV*T74Cd_F?dBgP(El%36HF@xT8FfbT2w`cD?}`p^2~
h^Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -489,7 +481,7 @@
 
    Some reasons you might want to use REST framework:
    
 
 
    Development
    
 
    See the Contribution guidelines for information on how to clone
diff --git a/topics/2.2-announcement/index.html b/topics/2.2-announcement/index.html
deleted file mode 100644
index 2a19330bc..000000000
--- a/topics/2.2-announcement/index.html
+++ /dev/null
@@ -1,546 +0,0 @@
-
-
-
-
-  
-  
-  2.2 Announcement - Django REST framework
-  
-  
-  
-  
-  
-
-  
-  
-  
-  
-  
-
-  
-  
-
-  
-
-  
-
-
-
-  
    
-
-        
    
-      
    
-        
    
-          GitHub
-          
-          
-           Search
-          
-            
-            
-            
-          
-          Django REST framework
-          
    
-            
-            
-            
-            
-          
    
-          
-
-        
    
-      
    
-    
    
-
-    
    
-      
    
-
-        
-        
-
-        
    
-
-          
    
-            
-            
    
-              
-
-            
    
-          
    
-
-          
    
-            
-
-            
    Django REST framework 2.2
    
-
    The 2.2 release represents an important point for REST framework, with the addition of Python 3 support, and the introduction of an official deprecation policy.
    
-
    Python 3 support
    
-
    Thanks to some fantastic work from Xavier Ordoquy, Django REST framework 2.2 now supports Python 3.  You'll need to be running Django 1.5, and it's worth keeping in mind that Django's Python 3 support is currently considered experimental.
    
-
    Django 1.6's Python 3 support is expected to be officially labeled as 'production-ready'.
    
-
    If you want to start ensuring that your own projects are Python 3 ready, we can highly recommend Django's Porting to Python 3 documentation.
    
-
    Django REST framework's Python 2.6 support now requires 2.6.5 or above, in line with Django 1.5's Python compatibility.
    
-
    Deprecation policy
    
-
    We've now introduced an official deprecation policy, which is in line with Django's deprecation policy.  This policy will make it easy for you to continue to track the latest, greatest version of REST framework.
    
-
    The timeline for deprecation works as follows:
    
-
      
-
    • 
-
      Version 2.2 introduces some API changes as detailed in the release notes.  It remains fully backwards compatible with 2.1, but will raise PendingDeprecationWarning warnings if you use bits of API that are due to be deprecated.  These warnings are silent by default, but can be explicitly enabled when you're ready to start migrating any required changes.  For example if you start running your tests using python -Wd manage.py test, you'll be warned of any API changes you need to make.
      
-
      • 
-
    • 
-
      Version 2.3 will escalate these warnings to DeprecationWarning, which is loud by default.
      
-
      • 
-
    • 
-
      Version 2.4 will remove the deprecated bits of API entirely.
      
-
      • 
-
    
-
    Note that in line with Django's policy, any parts of the framework not mentioned in the documentation should generally be considered private API, and may be subject to change.
    
-
    Community
    
-
    As of the 2.2 merge, we've also hit an impressive milestone.  The number of committers listed in the credits, is now at over one hundred individuals.  Each name on that list represents at least one merged pull request, however large or small.
    
-
    Our mailing list and #restframework IRC channel are also very active, and we've got a really impressive rate of development both on REST framework itself, and on third party packages such as the great django-rest-framework-docs package from Marc Gibbons.
    
-
    
-
    API changes
    
-
    The 2.2 release makes a few changes to the API, in order to make it more consistent, simple, and easier to use.
    
-
-
    The ManyRelatedField() style is being deprecated in favor of a new RelatedField(many=True) syntax.
    
-
    For example, if a user is associated with multiple questions, which we want to represent using a primary key relationship, we might use something like the following:
    
-
    class UserSerializer(serializers.HyperlinkedModelSerializer):
-    questions = serializers.PrimaryKeyRelatedField(many=True)
-
-    class Meta:
-        fields = ('username', 'questions')
-
    
-
    The new syntax is cleaner and more obvious, and the change will also make the documentation cleaner, simplify the internal API, and make writing custom relational fields easier.
    
-
    The change also applies to serializers.  If you have a nested serializer, you should start using many=True for to-many relationships.  For example, a serializer representation of an Album that can contain many Tracks might look something like this:
    
-
    class TrackSerializer(serializer.ModelSerializer):
-    class Meta:
-        model = Track
-        fields = ('name', 'duration')
-
-class AlbumSerializer(serializer.ModelSerializer):
-    tracks = TrackSerializer(many=True)
-
-    class Meta:
-        model = Album
-        fields = ('album_name', 'artist', 'tracks')
-
    
-
    Additionally, the change also applies when serializing or deserializing data.  For example to serialize a queryset of models you should now use the many=True flag.
    
-
    serializer = SnippetSerializer(Snippet.objects.all(), many=True)
-serializer.data
-
    
-
    This more explicit behavior on serializing and deserializing data makes integration with non-ORM backends such as MongoDB easier, as instances to be serialized can include the __iter__ method, without incorrectly triggering list-based serialization, or requiring workarounds.
    
-
    The implicit to-many behavior on serializers, and the ManyRelatedField style classes will continue to function, but will raise a PendingDeprecationWarning, which can be made visible using the -Wd flag.
    
-
    Note: If you need to forcibly turn off the implicit "many=True for __iter__ objects" behavior, you can now do so by specifying many=False.  This will become the default (instead of the current default of None) once the deprecation of the implicit behavior is finalised in version 2.4.
    
-
    Cleaner optional relationships
    
-
    Serializer relationships for nullable Foreign Keys will change from using the current null=True flag, to instead using required=False.
    
-
    For example, is a user account has an optional foreign key to a company, that you want to express using a hyperlink, you might use the following field in a Serializer class:
    
-
    current_company = serializers.HyperlinkedRelatedField(required=False)
-
    
-
    This is in line both with the rest of the serializer fields API, and with Django's Form and ModelForm API.
    
-
    Using required throughout the serializers API means you won't need to consider if a particular field should take blank or null arguments instead of required, and also means there will be more consistent behavior for how fields are treated when they are not present in the incoming data.
    
-
    The null=True argument will continue to function, and will imply required=False, but will raise a PendingDeprecationWarning.
    
-
    Cleaner CharField syntax
    
-
    The CharField API previously took an optional blank=True argument, which was intended to differentiate between null CharField input, and blank CharField input.
    
-
    In keeping with Django's CharField API, REST framework's CharField will only ever return the empty string, for missing or None inputs.  The blank flag will no longer be in use, and you should instead just use the required=<bool> flag.  For example:
    
-
    extra_details = CharField(required=False)
-
    
-
    The blank keyword argument will continue to function, but will raise a PendingDeprecationWarning.
    
-
    Simpler object-level permissions
    
-
    Custom permissions classes previously used the signature .has_permission(self, request, view, obj=None).  This method would be called twice, firstly for the global permissions check, with the obj parameter set to None, and again for the object-level permissions check when appropriate, with the obj parameter set to the relevant model instance.
    
-
    The global permissions check and object-level permissions check are now separated into two separate methods, which gives a cleaner, more obvious API.
    
-
      
-
    • Global permission checks now use the .has_permission(self, request, view) signature.
      • 
-
    • Object-level permission checks use a new method .has_object_permission(self, request, view, obj).
      • 
-
    
-
    For example, the following custom permission class:
    
-
    class IsOwner(permissions.BasePermission):
-    """
-    Custom permission to only allow owners of an object to view or edit it.
-    Model instances are expected to include an `owner` attribute.
-    """
-
-    def has_permission(self, request, view, obj=None):
-        if obj is None:
-            # Ignore global permissions check
-            return True
-
-        return obj.owner == request.user
-
    
-
    Now becomes:
    
-
    class IsOwner(permissions.BasePermission):
-    """
-    Custom permission to only allow owners of an object to view or edit it.
-    Model instances are expected to include an `owner` attribute.
-    """
-
-    def has_object_permission(self, request, view, obj):
-        return obj.owner == request.user
-
    
-
    If you're overriding the BasePermission class, the old-style signature will continue to function, and will correctly handle both global and object-level permissions checks, but its use will raise a PendingDeprecationWarning.
    
-
    Note also that the usage of the internal APIs for permission checking on the View class has been cleaned up slightly, and is now documented and subject to the deprecation policy in all future versions.
    
-
-
    When using a serializer with a HyperlinkedRelatedField or HyperlinkedIdentityField, the hyperlinks would previously use absolute URLs if the serializer context included a 'request' key, and fall back to using relative URLs otherwise.  This could lead to non-obvious behavior, as it might not be clear why some serializers generated absolute URLs, and others do not.
    
-
    From version 2.2 onwards, serializers with hyperlinked relationships always require a 'request' key to be supplied in the context dictionary.  The implicit behavior will continue to function, but its use will raise a PendingDeprecationWarning.
    
-
-          
    
-          
-        
    
-        
-      
    
-      
-    
    
-    
-    
    
-  
    
-  
-
-  
    
-    
    Documentation built with MkDocs.
-    
    
-  
    
-
-  
-  
-  
-  
-  
-  
-
-  
-
-
-
\ No newline at end of file
diff --git a/topics/2.3-announcement/index.html b/topics/2.3-announcement/index.html
deleted file mode 100644
index eb6b87287..000000000
--- a/topics/2.3-announcement/index.html
+++ /dev/null
@@ -1,683 +0,0 @@
-
-
-
-
-  
-  
-  2.3 Announcement - Django REST framework
-  
-  
-  
-  
-  
-
-  
-  
-  
-  
-  
-
-  
-  
-
-  
-
-  
-
-
-
-  
    
-
-        
    
-      
    
-        
    
-          GitHub
-          
-          
-           Search
-          
-            
-            
-            
-          
-          Django REST framework
-          
    
-            
-            
-            
-            
-          
    
-          
-
-        
    
-      
    
-    
    
-
-    
    
-      
    
-
-        
-        
-
-        
    
-
-          
    
-            
-            
-          
    
-
-          
    
-            
-
-            
    Django REST framework 2.3
    
-
    REST framework 2.3 makes it even quicker and easier to build your Web APIs.
    
-
    ViewSets and Routers
    
-
    The 2.3 release introduces the ViewSet and Router classes.
    
-
    A viewset is simply a type of class based view that allows you to group multiple views into a single common class.
    
-
    Routers allow you to automatically determine the URLconf for your viewset classes.
    
-
    As an example of just how simple REST framework APIs can now be, here's an API written in a single urls.py module:
    
-
    """
-A REST framework API for viewing and editing users and groups.
-"""
-from django.conf.urls.defaults import url, include
-from django.contrib.auth.models import User, Group
-from rest_framework import viewsets, routers
-
-
-# ViewSets define the view behavior.
-class UserViewSet(viewsets.ModelViewSet):
-    model = User
-
-class GroupViewSet(viewsets.ModelViewSet):
-    model = Group
-
-
-# Routers provide an easy way of automatically determining the URL conf
-router = routers.DefaultRouter()
-router.register(r'users', UserViewSet)
-router.register(r'groups', GroupViewSet)
-
-
-# Wire up our API using automatic URL routing.
-# Additionally, we include login URLs for the browsable API.
-urlpatterns = [
-    url(r'^', include(router.urls)),
-    url(r'^api-auth/', include('rest_framework.urls', namespace='rest_framework'))
-]
-
    
-
    The best place to get started with ViewSets and Routers is to take a look at the newest section in the tutorial, which demonstrates their usage.
    
-
    Simpler views
    
-
    This release rationalises the API and implementation of the generic views, dropping the dependency on Django's SingleObjectMixin and MultipleObjectMixin classes, removing a number of unneeded attributes, and generally making the implementation more obvious and easy to work with.
    
-
    This improvement is reflected in improved documentation for the GenericAPIView base class, and should make it easier to determine how to override methods on the base class if you need to write customized subclasses.
    
-
    Easier Serializers
    
-
    REST framework lets you be totally explicit regarding how you want to represent relationships, allowing you to choose between styles such as hyperlinking or primary key relationships.
    
-
    The ability to specify exactly how you want to represent relationships is powerful, but it also introduces complexity.  In order to keep things more simple, REST framework now allows you to include reverse relationships simply by including the field name in the fields metadata of the serializer class.
    
-
    For example, in REST framework 2.2, reverse relationships needed to be included explicitly on a serializer class.
    
-
    class BlogSerializer(serializers.ModelSerializer):
-    comments = serializers.PrimaryKeyRelatedField(many=True)
-
-    class Meta:
-        model = Blog
-        fields = ('id', 'title', 'created', 'comments')
-
    
-
    As of 2.3, you can simply include the field name, and the appropriate serializer field will automatically be used for the relationship.
    
-
    class BlogSerializer(serializers.ModelSerializer):
-    """
-    Don't need to specify the 'comments' field explicitly anymore.
-    """
-    class Meta:
-        model = Blog
-        fields = ('id', 'title', 'created', 'comments')
-
    
-
    Similarly, you can now easily include the primary key in hyperlinked relationships, simply by adding the field name to the metadata.
    
-
    class BlogSerializer(serializers.HyperlinkedModelSerializer):
-    """
-    This is a hyperlinked serializer, which default to using
-    a field named 'url' as the primary identifier.
-    Note that we can now easily also add in the 'id' field.
-    """
-    class Meta:
-        model = Blog
-        fields = ('url', 'id', 'title', 'created', 'comments')
-
    
-
    More flexible filtering
    
-
    The FILTER_BACKEND setting has moved to pending deprecation, in favor of a DEFAULT_FILTER_BACKENDS setting that takes a list of filter backend classes, instead of a single filter backend class.
    
-
    The generic view filter_backend attribute has also been moved to pending deprecation in favor of a filter_backends setting.
    
-
    Being able to specify multiple filters will allow for more flexible, powerful behavior.  New filter classes to handle searching and ordering of results are planned to be released shortly.
    
-
    
-
    API Changes
    
-
    Simplified generic view classes
    
-
    The functionality provided by SingleObjectAPIView and MultipleObjectAPIView base classes has now been moved into the base class GenericAPIView.  The implementation of this base class is simple enough that providing subclasses for the base classes of detail and list views is somewhat unnecessary.
    
-
    Additionally the base generic view no longer inherits from Django's SingleObjectMixin or MultipleObjectMixin classes, simplifying the implementation, and meaning you don't need to cross-reference across to Django's codebase.
    
-
    Using the SingleObjectAPIView and MultipleObjectAPIView base classes continues to be supported, but will raise a PendingDeprecationWarning.  You should instead simply use GenericAPIView as the base for any generic view subclasses.
    
-
    Removed attributes
    
-
    The following attributes and methods, were previously present as part of Django's generic view implementations, but were unneeded and unused and have now been entirely removed.
    
-
      
-
    • context_object_name
      • 
-
    • get_context_data()
      • 
-
    • get_context_object_name()
      • 
-
    
-
    The following attributes and methods, which were previously present as part of Django's generic view implementations have also been entirely removed.
    
-
      
-
    • paginator_class
      • 
-
    • get_paginator()
      • 
-
    • get_allow_empty()
      • 
-
    • get_slug_field()
      • 
-
    
-
    There may be cases when removing these bits of API might mean you need to write a little more code if your view has highly customized behavior, but generally we believe that providing a coarser-grained API will make the views easier to work with, and is the right trade-off to make for the vast majority of cases.
    
-
    Note that the listed attributes and methods have never been a documented part of the REST framework API, and as such are not covered by the deprecation policy.
    
-
    Simplified methods
    
-
    The get_object and get_paginate_by methods no longer take an optional queryset argument.  This makes overridden these methods more obvious, and a little more simple.
    
-
    Using an optional queryset with these methods continues to be supported, but will raise a PendingDeprecationWarning.
    
-
    The paginate_queryset method no longer takes a page_size argument, or returns a four-tuple of pagination information.  Instead it simply takes a queryset argument, and either returns a page object with an appropriate page size, or returns None, if pagination is not configured for the view.
    
-
    Using the page_size argument is still supported and will trigger the old-style return type, but will raise a PendingDeprecationWarning.
    
-
    Deprecated attributes
    
-
    The following attributes are used to control queryset lookup, and have all been moved into a pending deprecation state.
    
-
      
-
    • pk_url_kwarg = 'pk'
      • 
-
    • slug_url_kwarg = 'slug'
      • 
-
    • slug_field = 'slug'
      • 
-
    
-
    Their usage is replaced with a single attribute:
    
-
      
-
    • lookup_field = 'pk'
      • 
-
    
-
    This attribute is used both as the regex keyword argument in the URL conf, and as the model field to filter against when looking up a model instance.  To use non-pk based lookup, simply set the lookup_field argument to an alternative field, and ensure that the keyword argument in the url conf matches the field name.
    
-
    For example, a view with 'username' based lookup might look like this:
    
-
    class UserDetail(generics.RetrieveAPIView):
-    lookup_field = 'username'
-    queryset = User.objects.all()
-    serializer_class = UserSerializer
-
    
-
    And would have the following entry in the urlconf:
    
-
     url(r'^users/(?P<username>\w+)/$', UserDetail.as_view()),
-
    
-
    Usage of the old-style attributes continues to be supported, but will raise a PendingDeprecationWarning.
    
-
    The allow_empty attribute is also deprecated.  To use allow_empty=False style behavior you should explicitly override get_queryset and raise an Http404 on empty querysets.
    
-
    For example:
    
-
    class DisallowEmptyQuerysetMixin(object):
-    def get_queryset(self):
-        queryset = super(DisallowEmptyQuerysetMixin, self).get_queryset()
-        if not queryset.exists():
-            raise Http404
-        return queryset
-
    
-
    In our opinion removing lesser-used attributes like allow_empty helps us move towards simpler generic view implementations, making them more obvious to use and override, and re-enforcing the preferred style of developers writing their own base classes and mixins for custom behavior rather than relying on the configurability of the generic views.
    
-
    Simpler URL lookups
    
-
    The HyperlinkedRelatedField class now takes a single optional lookup_field argument, that replaces the pk_url_kwarg, slug_url_kwarg, and slug_field arguments.
    
-
    For example, you might have a field that references it's relationship by a hyperlink based on a slug field:
    
-
        account = HyperlinkedRelatedField(read_only=True,
-                                      lookup_field='slug',
-                                      view_name='account-detail')
-
    
-
    Usage of the old-style attributes continues to be supported, but will raise a PendingDeprecationWarning.
    
-
    FileUploadParser
    
-
    2.3 adds a FileUploadParser parser class, that supports raw file uploads, in addition to the existing multipart upload support.
    
-
    DecimalField
    
-
    2.3 introduces a DecimalField serializer field, which returns Decimal instances.
    
-
    For most cases APIs using model fields will behave as previously, however if you are using a custom renderer, not provided by REST framework, then you may now need to add support for rendering Decimal instances to your renderer implementation.
    
-
    ModelSerializers and reverse relationships
    
-
    The support for adding reverse relationships to the fields option on a ModelSerializer class means that the get_related_field and get_nested_field method signatures have now changed.
    
-
    In the unlikely event that you're providing a custom serializer class, and implementing these methods you should note the new call signature for both methods is now (self, model_field, related_model, to_many).  For reverse relationships model_field will be None.
    
-
    The old-style signature will continue to function but will raise a PendingDeprecationWarning.
    
-
    View names and descriptions
    
-
    The mechanics of how the names and descriptions used in the browsable API are generated has been modified and cleaned up somewhat.
    
-
    If you've been customizing this behavior, for example perhaps to use rst markup for the browsable API, then you'll need to take a look at the implementation to see what updates you need to make.
    
-
    Note that the relevant methods have always been private APIs, and the docstrings called them out as intended to be deprecated.
    
-
    
-
    Other notes
    
-
    More explicit style
    
-
    The usage of model attribute in generic Views is still supported, but it's usage is generally being discouraged throughout the documentation, in favour of the setting the more explicit queryset and serializer_class attributes.
    
-
    For example, the following is now the recommended style for using generic views:
    
-
    class AccountListView(generics.RetrieveAPIView):
-    queryset = MyModel.objects.all()
-    serializer_class = MyModelSerializer
-
    
-
    Using an explicit queryset and serializer_class attributes makes the functioning of the view more clear than using the shortcut model attribute.
    
-
    It also makes the usage of the get_queryset() or get_serializer_class() methods more obvious.
    
-
    class AccountListView(generics.RetrieveAPIView):
-    serializer_class = MyModelSerializer
-
-    def get_queryset(self):
-        """
-        Determine the queryset dynamically, depending on the
-        user making the request.
-
-        Note that overriding this method follows on more obviously now
-        that an explicit `queryset` attribute is the usual view style.
-        """
-        return self.user.accounts
-
    
-
    Django 1.3 support
    
-
    The 2.3.x release series will be the last series to provide compatibility with Django 1.3.
    
-
    Version 2.2 API changes
    
-
    All API changes in 2.2 that previously raised PendingDeprecationWarning will now raise a DeprecationWarning, which is loud by default.
    
-
    What comes next?
    
-
      
-
    • Support for read-write nested serializers is almost complete, and due to be released in the next few weeks.
      • 
-
    • Extra filter backends for searching and ordering of results are planned to be added shortly.
      • 
-
    
-
    The next few months should see a renewed focus on addressing outstanding tickets.  The 2.4 release is currently planned for around August-September.
    
-
-          
    
-          
-        
    
-        
-      
    
-      
-    
    
-    
-    
    
-  
    
-  
-
-  
    
-    
    Documentation built with MkDocs.
-    
    
-  
    
-
-  
-  
-  
-  
-  
-  
-
-  
-
-
-
\ No newline at end of file
diff --git a/topics/3.0-announcement/index.html b/topics/3.0-announcement/index.html
index ccd152e8e..056d6f31d 100644
--- a/topics/3.0-announcement/index.html
+++ b/topics/3.0-announcement/index.html
@@ -62,10 +62,10 @@
       
    
         
    
           GitHub
-          
-          
            Search
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
diff --git a/topics/2.4-announcement/index.html b/topics/3.1-announcement/index.html
similarity index 53%
rename from topics/2.4-announcement/index.html
rename to topics/3.1-announcement/index.html
index 2ea710fe4..f134c3ebb 100644
--- a/topics/2.4-announcement/index.html
+++ b/topics/3.1-announcement/index.html
@@ -4,11 +4,11 @@
 
   
   
-  2.4 Announcement - Django REST framework
+  3.1 Announcement - Django REST framework
   
-  
+  
   
-  
+  
   
 
   
@@ -62,10 +62,10 @@
       
    
         
    
           GitHub
-          
-          
            Search
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -260,23 +268,11 @@
                   
                   
                   
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
+                    3.0 Announcement
                   
    • 
                   
                   
  • 
-                    2.4 Announcement
-                  
    • 
-                  
-                  
  • 
-                    3.0 Announcement
+                    3.1 Announcement
                   
    • 
                   
                   
  • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
    • 
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -353,36 +345,32 @@
                 
 
                   
  • 
-                    Django REST framework 2.4
+                    Django REST framework 3.1
                   
    • 
 
                   
                     
  • 
-                      Version requirements
+                      Pagination
                     
    • 
                   
                     
  • 
-                      Django 1.7 support
+                      Versioning
                     
    • 
                   
                     
  • 
-                      Deprecation of .model view attribute
+                      Internationalization
                     
    • 
                   
                     
  • 
-                      Updated test runner
+                      New field types
                     
    • 
                   
                     
  • 
-                      Improved viewset routing
+                      ModelSerializer API
                     
    • 
                   
                     
  • 
-                      Throttle behavior
-                    
    • 
-                  
-                    
  • 
-                      Other features
+                      Moving packages out of core
                     
    • 
                   
                     
  • 
@@ -390,11 +378,7 @@
                     
    • 
                   
                     
  • 
-                      Labels and milestones
-                    
    • 
-                  
-                    
  • 
-                      Next steps
+                      What's next?
                     
    • 
                   
 
@@ -410,113 +394,148 @@
           
    
             
 
-            
    Django REST framework 2.4
    
-
    The 2.4 release is largely an intermediate step, tying up some outstanding issues prior to the 3.x series.
    
-
    Version requirements
    
-
    Support for Django 1.3 has been dropped.
-The lowest supported version of Django is now 1.4.2.
    
-
    The current plan is for REST framework to remain in lockstep with Django's long-term support policy.
    
-
    Django 1.7 support
    
-
    The optional authtoken application now includes support for both Django 1.7 schema migrations, and for old-style south migrations.
    
-
    If you are using authtoken, and you want to continue using south, you must upgrade your south package to version 1.0.
    
-
    Deprecation of .model view attribute
    
-
    The .model attribute on view classes is an optional shortcut for either or both of .serializer_class and .queryset. Its usage results in more implicit, less obvious behavior.
    
-
    The documentation has previously stated that usage of the more explicit style is prefered, and we're now taking that one step further and deprecating the usage of the .model shortcut.
    
-
    Doing so will mean that there are cases of API code where you'll now need to include a serializer class where you previously were just using the .model shortcut. However we firmly believe that it is the right trade-off to make.
    
-
    Removing the shortcut takes away an unnecessary layer of abstraction, and makes your codebase more explicit without any significant extra complexity. It also results in better consistency, as there's now only one way to set the serializer class and queryset attributes for the view, instead of two.
    
-
    The DEFAULT_MODEL_SERIALIZER_CLASS API setting is now also deprecated.
    
-
    Updated test runner
    
-
    We now have a new test runner for developing against the project,, that uses the excellent py.test library.
    
-
    To use it make sure you have first installed the test requirements.
    
-
    pip install -r requirements-test.txt
-
    
-
    Then run the runtests.py script.
    
-
    ./runtests.py
-
    
-
    The new test runner also includes flake8 code linting, which should help keep our coding style consistent.
    
-
    Test runner flags
    
-
    Run using a more concise output style.
    
-
    ./runtests -q
-
    
-
    Run the tests using a more concise output style, no coverage, no flake8.
    
-
    ./runtests --fast
-
    
-
    Don't run the flake8 code linting.
    
-
    ./runtests --nolint
-
    
-
    Only run the flake8 code linting, don't run the tests.
    
-
    ./runtests --lintonly
-
    
-
    Run the tests for a given test case.
    
-
    ./runtests MyTestCase
-
    
-
    Run the tests for a given test method.
    
-
    ./runtests MyTestCase.test_this_method
-
    
-
    Shorter form to run the tests for a given test method.
    
-
    ./runtests test_this_method
-
    
-
    Note: The test case and test method matching is fuzzy and will sometimes run other tests that contain a partial string match to the given  command line input.
    
-
    Improved viewset routing
    
-
    The @action and @link decorators were inflexible in that they only allowed additional routes to be added against instance style URLs, not against list style URLs.
    
-
    The @action and @link decorators have now been moved to pending deprecation, and the @list_route and @detail_route decorators have been introduced.
    
-
    Here's an example of using the new decorators. Firstly we have a detail-type route named "set_password" that acts on a single instance, and takes a pk argument in the URL. Secondly we have a list-type route named "recent_users" that acts on a queryset, and does not take any arguments in the URL.
    
-
    class UserViewSet(viewsets.ModelViewSet):
-    """
-    A viewset that provides the standard actions
-    """
-    queryset = User.objects.all()
-    serializer_class = UserSerializer
-
-    @detail_route(methods=['post'])
-    def set_password(self, request, pk=None):
-        user = self.get_object()
-        serializer = PasswordSerializer(data=request.DATA)
-        if serializer.is_valid():
-            user.set_password(serializer.data['password'])
-            user.save()
-            return Response({'status': 'password set'})
-        else:
-            return Response(serializer.errors,
-                            status=status.HTTP_400_BAD_REQUEST)
-
-    @list_route()
-    def recent_users(self, request):
-        recent_users = User.objects.all().order('-last_login')
-        page = self.paginate_queryset(recent_users)
-        serializer = self.get_pagination_serializer(page)
-        return Response(serializer.data)
-
    
-
    For more details, see the viewsets documentation.
    
-
    Throttle behavior
    
-
    There's one bugfix in 2.4 that's worth calling out, as it will invalidate existing throttle caches when you upgrade.
    
-
    We've now fixed a typo on the cache_format attribute. Previously this was named "throtte_%(scope)s_%(ident)s", it is now "throttle_%(scope)s_%(ident)s".
    
-
    If you're concerned about the invalidation you have two options.
    
+            
    Django REST framework 3.1
    
+
    The 3.1 release is an intermediate step in the Kickstarter project releases, and includes a range of new functionality.
    
+
    Some highlights include:
    
 
      
-
    • Manually pre-populate your cache with the fixed version.
      • 
-
    • Set the cache_format attribute on your throttle class in order to retain the previous incorrect spelling.
      • 
+
    • A super-smart cursor pagination scheme.
      • 
+
    • An improved pagination API, supporting header or in-body pagination styles.
      • 
+
    • Pagination controls rendering in the browsable API.
      • 
+
    • Better support for API versioning.
      • 
+
    • Built-in internationalization support.
      • 
+
    • Support for Django 1.8's HStoreField and ArrayField.
      • 
 
    
-
    Other features
    
-
    There are also a number of other features and bugfixes as listed in the release notes. In particular these include:
    
-
    Customizable view name and description functions for use with the browsable API, by using the VIEW_NAME_FUNCTION and VIEW_DESCRIPTION_FUNCTION settings.
    
-
    Smarter client IP identification for throttling, with the addition of the NUM_PROXIES setting.
    
-
    Added the standardized Retry-After header to throttled responses, as per RFC 6585. This should now be used in preference to the custom X-Throttle-Wait-Seconds header which will be fully deprecated in 3.0.
    
+
    
+
    Pagination
    
+
    The pagination API has been improved, making it both easier to use, and more powerful.
    
+
    A guide to the headline features follows. For full details, see the pagination documentation.
    
+
    Note that as a result of this work a number of settings keys and generic view attributes are now moved to pending deprecation. Controlling pagination styles is now largely handled by overriding a pagination class and modifying its configuration attributes.
    
+
      
+
    • The PAGINATE_BY settings key will continue to work but is now pending deprecation. The more obviously named PAGE_SIZE settings key should now be used instead.
      • 
+
    • The PAGINATE_BY_PARAM, MAX_PAGINATE_BY settings keys will continue to work but are now pending deprecation, in favor of setting configuration attributes on the configured pagination class.
      • 
+
    • The paginate_by, page_query_param, paginate_by_param and max_paginate_by generic view attributes will continue to work but are now pending deprecation, in favor of setting configuration attributes on the configured pagination class.
      • 
+
    • The pagination_serializer_class view attribute and DEFAULT_PAGINATION_SERIALIZER_CLASS settings key are no longer valid. The pagination API does not use serializers to determine the output format, and you'll need to instead override the get_paginated_response method on a pagination class in order to specify how the output format is controlled.
      • 
+
    
+
    New pagination schemes.
    
+
    Until now, there has only been a single built-in pagination style in REST framework. We now have page, limit/offset and cursor based schemes included by default.
    
+
    The cursor based pagination scheme is particularly smart, and is a better approach for clients iterating through large or frequently changing result sets. The scheme supports paging against non-unique indexes, by using both cursor and limit/offset information. It also allows for both forward and reverse cursor pagination. Much credit goes to David Cramer for this blog post on the subject.
    
+
    Pagination controls in the browsable API.
    
+
    Paginated results now include controls that render directly in the browsable API. If you're using the page or limit/offset style, then you'll see a page based control displayed in the browsable API:
    
+
    page number based pagination
    
+
    The cursor based pagination renders a more simple style of control:
    
+
    cursor based pagination
    
+
    Support for header-based pagination.
    
+
    The pagination API was previously only able to alter the pagination style in the body of the response. The API now supports being able to write pagination information in response headers, making it possible to use pagination schemes that use the Link or Content-Range headers.
    
+
    For more information, see the custom pagination styles documentation.
    
+
    
+
    Versioning
    
+
    We've made it easier to build versioned APIs. Built-in schemes for versioning include both URL based and Accept header based variations.
    
+
    When using a URL based scheme, hyperlinked serializers will resolve relationships to the same API version as used on the incoming request.
    
+
    For example, when using NamespaceVersioning, and the following hyperlinked serializer:
    
+
    class AccountsSerializer(serializer.HyperlinkedModelSerializer):
+    class Meta:
+        model = Accounts
+        fields = ('account_name', 'users')
+
    
+
    The output representation would match the version used on the incoming request. Like so:
    
+
    GET http://example.org/v2/accounts/10  # Version 'v2'
+
+{
+    "account_name": "europa",
+    "users": [
+        "http://example.org/v2/users/12",  # Version 'v2'
+        "http://example.org/v2/users/54",
+        "http://example.org/v2/users/87"
+    ]
+}
+
    
+
    
+
    Internationalization
    
+
    REST framework now includes a built-in set of translations, and supports internationalized error responses. This allows you to either change the default language, or to allow clients to specify the language via the Accept-Language header.
    
+
    You can change the default language by using the standard Django LANGUAGE_CODE setting:
    
+
    LANGUAGE_CODE = "es-es"
+
    
+
    You can turn on per-request language requests by adding LocalMiddleware to your MIDDLEWARE_CLASSES setting:
    
+
    MIDDLEWARE_CLASSES = [
+    ...
+    'django.middleware.locale.LocaleMiddleware'
+]
+
    
+
    When per-request internationalization is enabled, client requests will respect the Accept-Language header where possible. For example, let's make a request for an unsupported media type:
    
+
    Request
    
+
    GET /api/users HTTP/1.1
+Accept: application/xml
+Accept-Language: es-es
+Host: example.org
+
    
+
    Response
    
+
    HTTP/1.0 406 NOT ACCEPTABLE
+
+{
+    "detail": "No se ha podido satisfacer la solicitud de cabecera de Accept."
+}
+
    
+
    Note that the structure of the error responses is still the same. We still have a details key in the response. If needed you can modify this behavior too, by using a custom exception handler.
    
+
    We include built-in translations both for standard exception cases, and for serializer validation errors.
    
+
    The full list of supported languages can be found on our Transifex project page.
    
+
    If you only wish to support a subset of the supported languages, use Django's standard LANGUAGES setting:
    
+
    LANGUAGES = [
+    ('de', _('German')),
+    ('en', _('English')),
+]
+
    
+
    For more details, see the internationalization documentation.
    
+
    Many thanks to Craig Blaszczyk for helping push this through.
    
+
    
+
    New field types
    
+
    Django 1.8's new ArrayField, HStoreField and UUIDField are now all fully supported.
    
+
    This work also means that we now have both serializers.DictField(), and serializers.ListField() types, allowing you to express and validate a wider set of representations.
    
+
    If you're building a new 1.8 project, then you should probably consider using UUIDField as the primary keys for all your models. This style will work automatically with hyperlinked serializers, returning URLs in the following style:
    
+
    http://example.org/api/purchases/9b1a433f-e90d-4948-848b-300fdc26365d
+
    
+
    
+
    ModelSerializer API
    
+
    The serializer redesign in 3.0 did not include any public API for modifying how ModelSerializer classes automatically generate a set of fields from a given mode class. We've now re-introduced an API for this, allowing you to create new ModelSerializer base classes that behave differently, such as using a different default style for relationships.
    
+
    For more information, see the documentation on customizing field mappings for ModelSerializer classes.
    
+
    
+
    Moving packages out of core
    
+
    We've now moved a number of packages out of the core of REST framework, and into separately installable packages. If you're currently using these you don't need to worry, you simply need to pip install the new packages, and change any import paths.
    
+
    We're making this change in order to help distribute the maintainance workload, and keep better focus of the core essentials of the framework.
    
+
    The change also means we can be more flexible with which external packages we recommend. For example, the excellently maintained Django OAuth toolkit has now been promoted as our recommended option for integrating OAuth support.
    
+
    The following packages are now moved out of core and should be separately installed:
    
+
+
    It's worth reiterating that this change in policy shouldn't mean any work in your codebase other than adding a new requirement and modifying some import paths. For example to install XML rendering, you would now do:
    
+
    pip install djangorestframework-xml
+
    
+
    And modify your settings, like so:
    
+
    REST_FRAMEWORK = {
+    'DEFAULT_RENDERER_CLASSES': [
+        'rest_framework.renderers.JSONRenderer',
+        'rest_framework.renderers.BrowsableAPIRenderer',
+        'rest_framework_xml.renderers.XMLRenderer'
+    ]
+}
+
    
+
    Thanks go to the latest member of our maintenance team, José Padilla, for handling this work and taking on ownership of these packages.
    
+
    
 
    Deprecations
    
-
    All API changes in 2.3 that previously raised PendingDeprecationWarning will now raise a DeprecationWarning, which is loud by default.
    
-
    All API changes in 2.3 that previously raised DeprecationWarning have now been removed entirely.
    
-
    Furter details on these deprecations is available in the 2.3 announcement.
    
-
    Labels and milestones
    
-
    Although not strictly part of the 2.4 release it's also worth noting here that we've been working hard towards improving our triage process.
    
-
    The labels that we use in GitHub have been cleaned up, and all existing tickets triaged. Any given ticket should have one and only one label, indicating its current state.
    
-
    We've also started using milestones in order to track tickets against particular releases.
    
+
    The request.DATA, request.FILES and request.QUERY_PARAMS attributes move from pending deprecation, to deprecated. Use request.data and request.query_params instead, as discussed in the 3.0 release notes.
    
+
    The ModelSerializer Meta options for write_only_fields, view_name and lookup_field are also moved from pending deprecation, to deprecated. Use extra_kwargs instead, as discussed in the 3.0 release notes.
    
+
    All these attributes and options will still work in 3.1, but their usage will raise a warning. They will be fully removed in 3.2.
    
 
    
-
    Labels and milestones
    
-
    Above: Overview of our current use of labels and milestones in GitHub.
    
-
    
-
    We hope both of these changes will help make the management process more clear and obvious and help keep tickets well-organised and relevant.
    
-
    Next steps
    
-
    The next planned release will be 3.0, featuring an improved and simplified serializer implementation.
    
-
    Once again, many thanks to all the generous backers and sponsors who've helped make this possible!
    
+
    What's next?
    
+
    The next focus will be on HTML renderings of API output and will include:
    
+
      
+
    • HTML form rendering of serializers.
      • 
+
    • Filtering controls built-in to the browsable API.
      • 
+
    • An alternative admin-style interface.
      • 
+
    
+
    This will either be made as a single 3.2 release, or split across two separate releases, with the HTML forms and filter controls coming in 3.2, and the admin-style interface coming in a 3.3 release.
    
 
           
    
           
diff --git a/topics/ajax-csrf-cors/index.html b/topics/ajax-csrf-cors/index.html
index 64fa3d8dd..707774a90 100644
--- a/topics/ajax-csrf-cors/index.html
+++ b/topics/ajax-csrf-cors/index.html
@@ -65,7 +65,7 @@
           
-          
            Search
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
diff --git a/topics/browsable-api/index.html b/topics/browsable-api/index.html
index bd4a19922..251a897d3 100644
--- a/topics/browsable-api/index.html
+++ b/topics/browsable-api/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
diff --git a/topics/browser-enhancements/index.html b/topics/browser-enhancements/index.html
index 1a949705c..29970516f 100644
--- a/topics/browser-enhancements/index.html
+++ b/topics/browser-enhancements/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
diff --git a/topics/contributing/index.html b/topics/contributing/index.html
index 0a28159d5..ed151d63b 100644
--- a/topics/contributing/index.html
+++ b/topics/contributing/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
diff --git a/topics/credits/index.html b/topics/credits/index.html
deleted file mode 100644
index 545759982..000000000
--- a/topics/credits/index.html
+++ /dev/null
@@ -1,626 +0,0 @@
-
-
-
-
-  
-  
-  Credits - Django REST framework
-  
-  
-  
-  
-  
-
-  
-  
-  
-  
-  
-
-  
-  
-
-  
-
-  
-
-
-
-  
    
-
-        
    
-      
    
-        
    
-          GitHub
-          
-          
-           Search
-          
-            
-            
-            
-          
-          Django REST framework
-          
    
-            
-            
-            
-            
-          
    
-          
-
-        
    
-      
    
-    
    
-
-    
    
-      
    
-
-        
-        
-
-        
    
-
-          
    
-            
-            
    
-              
-
-            
    
-          
    
-
-          
    
-            
-
-            
    Credits
    
-
    The following people have helped make REST framework great.
    
-
-
    Many thanks to everyone who's contributed to the project.
    
-
    Additional thanks
    
-
    The documentation is built with Bootstrap and Markdown.
    
-
    Project hosting is with GitHub.
    
-
    Continuous integration testing is managed with Travis CI.
    
-
    The live sandbox is hosted on Heroku.
    
-
    Various inspiration taken from the Rails, Piston, Tastypie, Dagny and django-viewsets projects.
    
-
    Development of REST framework 2.0 was sponsored by DabApps.
    
-
    Contact
    
-
    For usage questions please see the REST framework discussion group.
    
-
    You can also contact @_tomchristie directly on twitter.
    
-
-          
    
-          
-        
    
-        
-      
    
-      
-    
    
-    
-    
    
-  
    
-  
-
-  
    
-    
    Documentation built with MkDocs.
-    
    
-  
    
-
-  
-  
-  
-  
-  
-  
-
-  
-
-
-
\ No newline at end of file
diff --git a/topics/documenting-your-api/index.html b/topics/documenting-your-api/index.html
index c40302fcc..1b0d9af26 100644
--- a/topics/documenting-your-api/index.html
+++ b/topics/documenting-your-api/index.html
@@ -62,7 +62,7 @@
       
    
         
    
           GitHub
-          
           Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
diff --git a/topics/rest-framework-2-announcement/index.html b/topics/internationalization/index.html
similarity index 62%
rename from topics/rest-framework-2-announcement/index.html
rename to topics/internationalization/index.html
index 18935f206..45ae801f4 100644
--- a/topics/rest-framework-2-announcement/index.html
+++ b/topics/internationalization/index.html
@@ -4,11 +4,11 @@
 
   
   
-  2.0 Announcement - Django REST framework
+  Internationalization - Django REST framework
   
-  
+  
   
-  
+  
   
 
   
@@ -62,10 +62,10 @@
       
    
         
    
           GitHub
-          
-          
            Search
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -353,40 +345,20 @@
                 
 
                   
  • 
-                    Django REST framework 2.0
+                    Internationalization
                   
    • 
 
                   
                     
  • 
-                      User feedback
+                      Enabling internationalized APIs
                     
    • 
                   
                     
  • 
-                      Serialization
+                      Adding new translations
                     
    • 
                   
                     
  • 
-                      Generic views
-                    
    • 
-                  
-                    
  • 
-                      Requests, Responses & Views
-                    
    • 
-                  
-                    
  • 
-                      API Design
-                    
    • 
-                  
-                    
  • 
-                      The Browsable API
-                    
    • 
-                  
-                    
  • 
-                      Documentation
-                    
    • 
-                  
-                    
  • 
-                      Summary
+                      How the language is determined
                     
    • 
                   
 
@@ -402,57 +374,95 @@
           
    
             
 
-            
    Django REST framework 2.0
    
+            
    Internationalization
    
 
    
-
    Most people just make the mistake that it should be simple to design simple things.  In reality, the effort required to design something is inversely proportional to the simplicity of the result.
    
-
    — Roy Fielding
    
+
    Supporting internationalization is not optional. It must be a core feature.
    
+
    — Jannis Leidel, speaking at Django Under the Hood, 2015.
    
 
    
-
    
-
    Announcement: REST framework 2 released - Tue 30th Oct 2012
    
-
    
-
    REST framework 2 is an almost complete reworking of the original framework, which comprehensively addresses some of the original design issues.
    
-
    Because the latest version should be considered a re-release, rather than an incremental improvement, we've skipped a version, and called this release Django REST framework 2.0.
    
-
    This article is intended to give you a flavor of what REST framework 2 is, and why you might want to give it a try.
    
-
    User feedback
    
-
    Before we get cracking, let's start with the hard sell, with a few bits of feedback from some early adopters…
    
-
    "Django REST framework 2 is beautiful.  Some of the API design is worthy of @kennethreitz." - Kit La Touche
    
-
    "Since it's pretty much just Django, controlling things like URLs has been a breeze...  I think [REST framework 2] has definitely got the right approach here; even simple things like being able to override a function called post to do custom work during rather than having to intimately know what happens during a post make a huge difference to your productivity." - Ian Strachan
    
-
    "I switched to the 2.0 branch and I don't regret it - fully refactored my code in another ½ day and it's much more to my tastes" - Bruno Desthuilliers
    
-
    Sounds good, right?  Let's get into some details...
    
-
    Serialization
    
-
    REST framework 2 includes a totally re-worked serialization engine, that was initially intended as a replacement for Django's existing inflexible fixture serialization, and which meets the following design goals:
    
+
    REST framework ships with translatable error messages. You can make these appear in your language enabling Django's standard translation mechanisms.
    
+
    Doing so will allow you to:
    
 
      
-
    • A declarative serialization API, that mirrors Django's Forms/ModelForms API.
      • 
-
    • Structural concerns are decoupled from encoding concerns.
      • 
-
    • Able to support rendering and parsing to many formats, including both machine-readable representations and HTML forms.
      • 
-
    • Validation that can be mapped to obvious and comprehensive error responses.
      • 
-
    • Serializers that support both nested, flat, and partially-nested representations.
      • 
-
    • Relationships that can be expressed as primary keys, hyperlinks, slug fields, and other custom representations.
      • 
+
    • Select a language other than English as the default, using the standard LANGUAGE_CODE Django setting.
      • 
+
    • Allow clients to choose a language themselves, using the LocaleMiddleware included with Django. A typical usage for API clients would be to include an Accept-Language request header.
      • 
 
    
-
    Mapping between the internal state of the system and external representations of that state is the core concern of building Web APIs.  Designing serializers that allow the developer to do so in a flexible and obvious way is a deceptively difficult design task, and with the new serialization API we think we've pretty much nailed it.
    
-
    Generic views
    
-
    When REST framework was initially released at the start of 2011, the current Django release was version 1.2.  REST framework included a backport of Django 1.3's upcoming View class, but it didn't take full advantage of the generic view implementations.
    
-
    With the new release the generic views in REST framework now tie in with Django's generic views.  The end result is that framework is clean, lightweight and easy to use.
    
-
    Requests, Responses & Views
    
-
    REST framework 2 includes Request and Response classes, than are used in place of Django's existing HttpRequest and HttpResponse classes.  Doing so allows logic such as parsing the incoming request or rendering the outgoing response to be supported transparently by the framework.
    
-
    The Request/Response approach leads to a much cleaner API, less logic in the view itself, and a simple, obvious request-response cycle.
    
-
    REST framework 2 also allows you to work with both function-based and class-based views.  For simple API views all you need is a single @api_view decorator, and you're good to go.
    
-
    API Design
    
-
    Pretty much every aspect of REST framework has been reworked, with the aim of ironing out some of the design flaws of the previous versions.  Each of the components of REST framework are cleanly decoupled, and can be used independently of each-other, and there are no monolithic resource classes, overcomplicated mixin combinations, or opinionated serialization or URL routing decisions.
    
-
    The Browsable API
    
-
    Django REST framework's most unique feature is the way it is able to serve up both machine-readable representations, and a fully browsable HTML representation to the same endpoints.
    
-
    Browsable Web APIs are easier to work with, visualize and debug, and generally makes it easier and more frictionless to inspect and work with.
    
-
    With REST framework 2, the browsable API gets a snazzy new bootstrap-based theme that looks great and is even nicer to work with.
    
-
    There are also some functionality improvements - actions such as as POST and DELETE will only display if the user has the appropriate permissions.
    
-
    Browsable API
    
-
    Image above: An example of the browsable API in REST framework 2
    
-
    Documentation
    
-
    As you can see the documentation for REST framework has been radically improved.  It gets a completely new style, using markdown for the documentation source, and a bootstrap-based theme for the styling.
    
-
    We're really pleased with how the docs style looks - it's simple and clean, is easy to navigate around, and we think it reads great.
    
-
    Summary
    
-
    In short, we've engineered the hell outta this thing, and we're incredibly proud of the result.
    
-
    If you're interested please take a browse around the documentation.  The tutorial is a great place to get started.
    
-
    There's also a live sandbox version of the tutorial API available for testing.
    
+
    Enabling internationalized APIs
    
+
    You can change the default language by using the standard Django LANGUAGE_CODE setting:
    
+
    LANGUAGE_CODE = "es-es"
+
    
+
    You can turn on per-request language requests by adding LocalMiddleware to your MIDDLEWARE_CLASSES setting:
    
+
    MIDDLEWARE_CLASSES = [
+    ...
+    'django.middleware.locale.LocaleMiddleware'
+]
+
    
+
    When per-request internationalization is enabled, client requests will respect the Accept-Language header where possible. For example, let's make a request for an unsupported media type:
    
+
    Request
    
+
    GET /api/users HTTP/1.1
+Accept: application/xml
+Accept-Language: es-es
+Host: example.org
+
    
+
    Response
    
+
    HTTP/1.0 406 NOT ACCEPTABLE
+
+{"detail": "No se ha podido satisfacer la solicitud de cabecera de Accept."}
+
    
+
    REST framework includes these built-in translations both for standard exception cases, and for serializer validation errors.
    
+
    Note that the translations only apply to the error strings themselves. The format of error messages, and the keys of field names will remain the same. An example 400 Bad Request response body might look like this:
    
+
    {"detail": {"username": ["Esse campo deve ser unico."]}}
+
    
+
    If you want to use different string for parts of the response such as detail and non_field_errors then you can modify this behavior by using a custom exception handler.
    
+
    Specifying the set of supported languages.
    
+
    By default all available languages will be supported.
    
+
    If you only wish to support a subset of the available languages, use Django's standard LANGUAGES setting:
    
+
    LANGUAGES = [
+    ('de', _('German')),
+    ('en', _('English')),
+]
+
    
+
    Adding new translations
    
+
    REST framework translations are managed online using Transifex. You can use the Transifex service to add new translation languages. The maintenance team will then ensure that these translation strings are included in the REST framework package.
    
+
    Sometimes you may need to add translation strings to your project locally. You may need to do this if:
    
+
      
+
    • You want to use REST Framework in a language which has not been translated yet on Transifex.
      • 
+
    • Your project includes custom error messages, which are not part of REST framework's default translation strings.
      • 
+
    
+
    Translating a new language locally
    
+
    This guide assumes you are already familiar with how to translate a Django app.  If you're not, start by reading Django's translation docs.
    
+
    If you're translating a new language you'll need to translate the existing REST framework error messages:
    
+
      
+
    1. 
+
      Make a new folder where you want to store the internationalization resources. Add this path to your LOCALE_PATHS setting.
      
+
      2. 
+
    2. 
+
      Now create a subfolder for the language you want to translate. The folder should be named using locale name notation. For example: de, pt_BR, es_AR.
      
+
      3. 
+
    3. 
+
      Now copy the base translations file from the REST framework source code into your translations folder.
      
+
      4. 
+
    4. 
+
      Edit the django.po file you've just copied, translating all the error messages.
      
+
      5. 
+
    5. 
+
      Run manage.py compilemessages -l pt_BR to make the translations 
+available for Django to use. You should see a message like processing file django.po in <...>/locale/pt_BR/LC_MESSAGES.
      
+
      6. 
+
    6. 
+
      Restart your development server to see the changes take effect.
      
+
      7. 
+
    
+
    If you're only translating custom error messages that exist inside your project codebase you don't need to copy the REST framework source django.po file into a LOCALE_PATHS folder, and can instead simply run Django's standard makemessages process.
    
+
    How the language is determined
    
+
    If you want to allow per-request language preferences you'll need to include django.middleware.locale.LocaleMiddleware in your MIDDLEWARE_CLASSES setting.
    
+
    You can find more information on how the language preference is determined in the Django documentation. For reference, the method is:
    
+
      
+
    1. First, it looks for the language prefix in the requested URL.
      2. 
+
    2. Failing that, it looks for the LANGUAGE_SESSION_KEY key in the current user’s session.
      3. 
+
    3. Failing that, it looks for a cookie.
      4. 
+
    4. Failing that, it looks at the Accept-Language HTTP header.
      5. 
+
    5. Failing that, it uses the global LANGUAGE_CODE setting.
      6. 
+
    
+
    For API clients the most appropriate of these will typically be to use the Accept-Language header; Sessions and cookies will not be available unless using session authentication, and generally better practice to prefer an Accept-Language header for API clients rather than using language URL prefixes.
    
 
           
    
           
diff --git a/topics/kickstarter-announcement/index.html b/topics/kickstarter-announcement/index.html
index f736ad9c8..2fbbaaa4e 100644
--- a/topics/kickstarter-announcement/index.html
+++ b/topics/kickstarter-announcement/index.html
@@ -65,7 +65,7 @@
           
-          
            Search
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
diff --git a/topics/project-management/index.html b/topics/project-management/index.html
index 91fa23596..cc7135ac7 100644
--- a/topics/project-management/index.html
+++ b/topics/project-management/index.html
@@ -62,7 +62,7 @@
       
    
         
    
           GitHub
-          
           Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -365,6 +357,14 @@
                       Release process
                     
                   
+                    
  • 
+                      Translations
+                    
    • 
+                  
+                    
  • 
+                      Project requirements
+                    
    • 
+                  
                     
  • 
                       Project ownership
                     
    • 
@@ -438,10 +438,11 @@ To modify this process for future maintenance cycles make a pull request to the
 
    Responsibilities of team members
    
 
    Team members have the following responsibilities.
    
 
      
-
    • Add triage labels and milestones to tickets.
      • 
 
    • Close invalid or resolved tickets.
      • 
+
    • Add triage labels and milestones to tickets.
      • 
 
    • Merge finalized pull requests.
      • 
 
    • Build and deploy the documentation, using mkdocs gh-deploy.
      • 
+
    • Build and update the included translation packs.
      • 
 
    
 
    Further notes for maintainers:
    
 
      
@@ -482,6 +483,48 @@ To modify this process for future releases make a pull request to the [project m
 
    
 
    When pushing the release to PyPI ensure that your environment has been installed from our development requirement.txt, so that documentation and PyPI installs are consistently being built against a pinned set of packages.
    
 
    
+
    Translations
    
+
    The maintenance team are responsible for managing the translation packs include in REST framework. Translating the source strings into multiple languages is managed through the transifex service.
    
+
    Managing Transifex
    
+
    The official Transifex client is used to upload and download translations to Transifex. The client is installed using pip:
    
+
    pip install transifex-client
+
    
+
    To use it you'll need a login to Transifex which has a password, and you'll need to have administrative access to the Transifex project. You'll need to create a ~/.transifexrc file which contains your credentials.
    
+
    [https://www.transifex.com]
+username = ***
+token = ***
+password = ***
+hostname = https://www.transifex.com
+
    
+
    Upload new source files
    
+
    When any user visible strings are changed, they should be uploaded to Transifex so that the translators can start to translate them. To do this, just run:
    
+
    # 1. Update the source django.po file, which is the US English version.
+cd rest_framework
+django-admin.py makemessages -l en_US
+# 2. Push the source django.po file to Transifex.
+cd ..
+tx push -s
+
    
+
    When pushing source files, Transifex will update the source strings of a resource to match those from the new source file.
    
+
    Here's how differences between the old and new source files will be handled:
    
+
      
+
    • New strings will be added.
      • 
+
    • Modified strings will be added as well.
      • 
+
    • Strings which do not exist in the new source file will be removed from the database, along with their translations. If that source strings gets re-added later then Transifex Translation Memory will automatically include the translation string.
      • 
+
    
+
    Download translations
    
+
    When a translator has finished translating their work needs to be downloaded from Transifex into the REST framework repository. To do this, run:
    
+
    # 3. Pull the translated django.po files from Transifex.
+tx pull -a
+cd rest_framework
+# 4. Compile the binary .mo files for all supported languages.
+django-admin.py compilemessages
+
    
+
    
+
    Project requirements
    
+
    All our test requirements are pinned to exact versions, in order to ensure that our test runs are reproducible. We maintain the requirements in the requirements directory. The requirements files are referenced from the tox.ini configuration file, ensuring we have a single source of truth for package versions used in testing.
    
+
    Package upgrades should generally be treated as isolated pull requests. You can check if there are any packages available at a newer version, by using the pip list --outdated.
    
+
    
 
    Project ownership
    
 
    The PyPI package is owned by @tomchristie. As a backup @j4mie also has ownership of the package.
    
 
    If @tomchristie ceases to participate in the project then @j4mie has responsibility for handing over ownership duties.
    
diff --git a/topics/release-notes/index.html b/topics/release-notes/index.html
index 2d66b25f3..5e0a86b96 100644
--- a/topics/release-notes/index.html
+++ b/topics/release-notes/index.html
@@ -62,7 +62,7 @@
       
    
         
    
           GitHub
-          
           Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -373,26 +365,6 @@
                       3.0.x series
                     
                   
-                    
  • 
-                      2.4.x series
-                    
    • 
-                  
-                    
  • 
-                      2.3.x series
-                    
    • 
-                  
-                    
  • 
-                      2.2.x series
-                    
    • 
-                  
-                    
  • 
-                      2.1.x series
-                    
    • 
-                  
-                    
  • 
-                      2.0.x series
-                    
    • 
-                  
 
                 
 
@@ -439,6 +411,9 @@
 
    
 
    
 
    3.0.x series
    
+
    3.1.0
    
+
    Date: [5th March 2015][3.1.0-milestone].
    
+
    For full details see the 3.1 release announcement.
    
 
    3.0.5
    
 
    Date: 10th February 2015.
    
 
      
@@ -526,509 +501,7 @@
 
      Date: 1st December 2014
      
 
      For full details see the 3.0 release announcement.
      
 
      
-
      2.4.x series
      
-
      2.4.4
      
-
      Date: 3rd November 2014.
      
-
        
-
      • Security fix: Escape URLs when replacing format= query parameter, as used in dropdown on GET button in browsable API to allow explicit selection of JSON vs HTML output.
        • 
-
      • Maintain ordering of URLs in API root view for DefaultRouter.
        • 
-
      • Fix follow=True in APIRequestFactory
        • 
-
      • Resolve issue with invalid read_only=True, required=True fields being automatically generated by ModelSerializer in some cases.
        • 
-
      • Resolve issue with OPTIONS requests returning incorrect information for views using get_serializer_class to dynamically determine serializer based on request method. 
        • 
-
      
-
      2.4.3
      
-
      Date: 19th September 2014.
      
-
        
-
      • Support translatable view docstrings being displayed in the browsable API.
        • 
-
      • Support encoded filename* in raw file uploads with FileUploadParser.
        • 
-
      • Allow routers to support viewsets that don't include any list routes or that don't include any detail routes.
        • 
-
      • Don't render an empty login control in browsable API if login view is not included.
        • 
-
      • CSRF exemption performed in .as_view() to prevent accidental omission if overriding .dispatch().
        • 
-
      • Login on browsable API now displays validation errors.
        • 
-
      • Bugfix: Fix migration in authtoken application.
        • 
-
      • Bugfix: Allow selection of integer keys in nested choices.
        • 
-
      • Bugfix: Return None instead of 'None' in CharField with allow_none=True.
        • 
-
      • Bugfix: Ensure custom model fields map to equivelent serializer fields more reliably.
        • 
-
      • Bugfix: DjangoFilterBackend no longer quietly changes queryset ordering.
        • 
-
      
-
      2.4.2
      
-
      Date: 3rd September 2014.
      
-
        
-
      • Bugfix: Fix broken pagination for 2.4.x series.
        • 
-
      
-
      2.4.1
      
-
      Date: 1st September 2014.
      
-
        
-
      • Bugfix: Fix broken login template for browsable API.
        • 
-
      
-
      2.4.0
      
-
      Date: 29th August 2014.
      
-
      Django version requirements: The lowest supported version of Django is now 1.4.2.
      
-
      South version requirements: This note applies to any users using the optional authtoken application, which includes an associated database migration. You must now either upgrade your south package to version 1.0, or instead use the built-in migration support available with Django 1.7.
      
-
        
-
      • Added compatibility with Django 1.7's database migration support.
        • 
-
      • New test runner, using py.test.
        • 
-
      • Deprecated .model view attribute in favor of explicit .queryset and .serializer_class attributes. The DEFAULT_MODEL_SERIALIZER_CLASS setting is also deprecated.
        • 
-
      • @detail_route and @list_route decorators replace @action and @link.
        • 
-
      • Support customizable view name and description functions, using the VIEW_NAME_FUNCTION and VIEW_DESCRIPTION_FUNCTION settings.
        • 
-
      • Added NUM_PROXIES setting for smarter client IP identification.
        • 
-
      • Added MAX_PAGINATE_BY setting and max_paginate_by generic view attribute.
        • 
-
      • Added Retry-After header to throttled responses, as per RFC 6585. This should now be used in preference to the custom X-Trottle-Wait-Seconds header which will be fully deprecated in 3.0.
        • 
-
      • Added cache attribute to throttles to allow overriding of default cache.
        • 
-
      • Added lookup_value_regex attribute to routers, to allow the URL argument matching to be constrainted by the user.
        • 
-
      • Added allow_none option to CharField.
        • 
-
      • Support Django's standard status_code class attribute on responses.
        • 
-
      • More intuitive behavior on the test client, as client.logout() now also removes any credentials that have been set.
        • 
-
      • Bugfix: ?page_size=0 query parameter now falls back to default page size for view, instead of always turning pagination off.
        • 
-
      • Bugfix: Always uppercase X-Http-Method-Override methods.
        • 
-
      • Bugfix: Copy filter_backends list before returning it, in order to prevent view code from mutating the class attribute itself.
        • 
-
      • Bugfix: Set the .action attribute on viewsets when introspected by OPTIONS for testing permissions on the view.
        • 
-
      • Bugfix: Ensure ValueError raised during deserialization results in a error list rather than a single error. This is now consistent with other validation errors.
        • 
-
      • Bugfix: Fix cache_format typo on throttle classes, was "throtte_%(scope)s_%(ident)s". Note that this will invalidate existing throttle caches.
        • 
-
      
-
      
-
      2.3.x series
      
-
      2.3.14
      
-
      Date: 12th June 2014
      
-
        
-
      • Security fix: Escape request path when it is include as part of the login and logout links in the browsable API.
        • 
-
      • help_text and verbose_name automatically set for related fields on ModelSerializer.
        • 
-
      • Fix nested serializers linked through a backward foreign key relation.
        • 
-
      • Fix bad links for the BrowsableAPIRenderer with YAMLRenderer.
        • 
-
      • Add UnicodeYAMLRenderer that extends YAMLRenderer with unicode.
        • 
-
      • Fix parse_header argument convertion.
        • 
-
      • Fix mediatype detection under Python 3.
        • 
-
      • Web browsable API now offers blank option on dropdown when the field is not required.
        • 
-
      • APIException representation improved for logging purposes.
        • 
-
      • Allow source="*" within nested serializers.
        • 
-
      • Better support for custom oauth2 provider backends.
        • 
-
      • Fix field validation if it's optional and has no value.
        • 
-
      • Add SEARCH_PARAM and ORDERING_PARAM.
        • 
-
      • Fix APIRequestFactory to support arguments within the url string for GET.
        • 
-
      • Allow three transport modes for access tokens when accessing a protected resource.
        • 
-
      • Fix QueryDict encoding on request objects.
        • 
-
      • Ensure throttle keys do not contain spaces, as those are invalid if using memcached.
        • 
-
      • Support blank_display_value on ChoiceField.
        • 
-
      
-
      2.3.13
      
-
      Date: 6th March 2014
      
-
        
-
      • Django 1.7 Support.
        • 
-
      • Fix default argument when used with serializer relation fields.
        • 
-
      • Display the media type of the content that is being displayed in the browsable API, rather than 'text/html'.
        • 
-
      • Bugfix for urlize template failure when URL regex is matched, but value does not urlparse.
        • 
-
      • Use urandom for token generation.
        • 
-
      • Only use Vary: Accept when more than one renderer exists.
        • 
-
      
-
      2.3.12
      
-
      Date: 15th January 2014
      
-
        
-
      • Security fix: OrderingField now only allows ordering on readable serializer fields, or on fields explicitly specified using ordering_fields. This prevents users being able to order by fields that are not visible in the API, and exploiting the ordering of sensitive data such as password hashes.
        • 
-
      • Bugfix: write_only = True fields now display in the browsable API.
        • 
-
      
-
      2.3.11
      
-
      Date: 14th January 2014
      
-
        
-
      • Added write_only serializer field argument.
        • 
-
      • Added write_only_fields option to ModelSerializer classes.
        • 
-
      • JSON renderer now deals with objects that implement a dict-like interface.
        • 
-
      • Fix compatiblity with newer versions of django-oauth-plus.
        • 
-
      • Bugfix: Refine behavior that calls model manager all() across nested serializer relationships, preventing erronous behavior with some non-ORM objects, and preventing unnecessary queryset re-evaluations.
        • 
-
      • Bugfix: Allow defaults on BooleanFields to be properly honored when values are not supplied.
        • 
-
      • Bugfix: Prevent double-escaping of non-latin1 URL query params when appending format=json params.
        • 
-
      
-
      2.3.10
      
-
      Date: 6th December 2013
      
-
        
-
      • Add in choices information for ChoiceFields in response to OPTIONS requests.
        • 
-
      • Added pre_delete() and post_delete() method hooks.
        • 
-
      • Added status code category helper functions.
        • 
-
      • Bugfix: Partial updates which erronously set a related field to None now correctly fail validation instead of raising an exception.
        • 
-
      • Bugfix: Responses without any content no longer include an HTTP 'Content-Type' header.
        • 
-
      • Bugfix: Correctly handle validation errors in PUT-as-create case, responding with 400.
        • 
-
      
-
      2.3.9
      
-
      Date: 15th November 2013
      
-
        
-
      • Fix Django 1.6 exception API compatibility issue caused by ValidationError.
        • 
-
      • Include errors in HTML forms in browsable API.
        • 
-
      • Added JSON renderer support for numpy scalars.
        • 
-
      • Added transform_<fieldname> hooks on serializers for easily modifying field output.
        • 
-
      • Added get_context hook in BrowsableAPIRenderer.
        • 
-
      • Allow serializers to be passed files but no data.
        • 
-
      • HTMLFormRenderer now renders serializers directly to HTML without needing to create an intermediate form object.
        • 
-
      • Added get_filter_backends hook.
        • 
-
      • Added queryset aggregates to allowed fields in OrderingFilter.
        • 
-
      • Bugfix: Fix decimal suppoprt with YAMLRenderer.
        • 
-
      • Bugfix: Fix submission of unicode in browsable API through raw data form.
        • 
-
      
-
      2.3.8
      
-
      Date: 11th September 2013
      
-
        
-
      • Added DjangoObjectPermissions, and DjangoObjectPermissionsFilter.
        • 
-
      • Support customizable exception handling, using the EXCEPTION_HANDLER setting.
        • 
-
      • Support customizable view name and description functions, using the VIEW_NAME_FUNCTION and VIEW_DESCRIPTION_FUNCTION settings.
        • 
-
      • Added MAX_PAGINATE_BY setting and max_paginate_by generic view attribute.
        • 
-
      • Added cache attribute to throttles to allow overriding of default cache.
        • 
-
      • 'Raw data' tab in browsable API now contains pre-populated data.
        • 
-
      • 'Raw data' and 'HTML form' tab preference in browsable API now saved between page views.
        • 
-
      • Bugfix: required=True argument fixed for boolean serializer fields.
        • 
-
      • Bugfix: client.force_authenticate(None) should also clear session info if it exists.
        • 
-
      • Bugfix: Client sending empty string instead of file now clears FileField.
        • 
-
      • Bugfix: Empty values on ChoiceFields with required=False now consistently return None.
        • 
-
      • Bugfix: Clients setting page_size=0 now simply returns the default page size, instead of disabling pagination. [*]
        • 
-
      
-
      
-
      [*] Note that the change in page_size=0 behaviour fixes what is considered to be a bug in how clients can effect the pagination size.  However if you were relying on this behavior you will need to add the following mixin to your list views in order to preserve the existing behavior.
      
-
      class DisablePaginationMixin(object):
-    def get_paginate_by(self, queryset=None):
-        if self.request.QUERY_PARAMS[self.paginate_by_param] == '0':
-            return None
-        return super(DisablePaginationMixin, self).get_paginate_by(queryset)
-
      
-
      
-
      2.3.7
      
-
      Date: 16th August 2013
      
-
        
-
      • Added APITestClient, APIRequestFactory and APITestCase etc...
        • 
-
      • Refactor SessionAuthentication to allow esier override for CSRF exemption.
        • 
-
      • Remove 'Hold down "Control" message from help_text' widget messaging when not appropriate.
        • 
-
      • Added admin configuration for auth tokens.
        • 
-
      • Bugfix: AnonRateThrottle fixed to not throttle authenticated users.
        • 
-
      • Bugfix: Don't set X-Throttle-Wait-Seconds when throttle does not have wait value.
        • 
-
      • Bugfix: Fixed PATCH button title in browsable API.
        • 
-
      • Bugfix: Fix issue with OAuth2 provider naive datetimes.
        • 
-
      
-
      2.3.6
      
-
      Date: 27th June 2013
      
-
        
-
      • Added trailing_slash option to routers.
        • 
-
      • Include support for HttpStreamingResponse.
        • 
-
      • Support wider range of default serializer validation when used with custom model fields.
        • 
-
      • UTF-8 Support for browsable API descriptions.
        • 
-
      • OAuth2 provider uses timezone aware datetimes when supported.
        • 
-
      • Bugfix: Return error correctly when OAuth non-existent consumer occurs.
        • 
-
      • Bugfix: Allow FileUploadParser to correctly filename if provided as URL kwarg.
        • 
-
      • Bugfix: Fix ScopedRateThrottle.
        • 
-
      
-
      2.3.5
      
-
      Date: 3rd June 2013
      
-
        
-
      • Added get_url hook to HyperlinkedIdentityField.
        • 
-
      • Serializer field default argument may be a callable.
        • 
-
      • @action decorator now accepts a methods argument.
        • 
-
      • Bugfix: request.user should be still be accessible in renderer context if authentication fails.
        • 
-
      • Bugfix: The lookup_field option on HyperlinkedIdentityField should apply by default to the url field on the serializer.
        • 
-
      • Bugfix: HyperlinkedIdentityField should continue to support pk_url_kwarg, slug_url_kwarg, slug_field, in a pending deprecation state.
        • 
-
      • Bugfix: Ensure we always return 404 instead of 500 if a lookup field cannot be converted to the correct lookup type.  (Eg non-numeric AutoInteger pk lookup)
        • 
-
      
-
      2.3.4
      
-
      Date: 24th May 2013
      
-
        
-
      • Serializer fields now support label and help_text.
        • 
-
      • Added UnicodeJSONRenderer.
        • 
-
      • OPTIONS requests now return metadata about fields for POST and PUT requests.
        • 
-
      • Bugfix: charset now properly included in Content-Type of responses.
        • 
-
      • Bugfix: Blank choice now added in browsable API on nullable relationships.
        • 
-
      • Bugfix: Many to many relationships with through tables are now read-only.
        • 
-
      • Bugfix: Serializer fields now respect model field args such as max_length.
        • 
-
      • Bugfix: SlugField now performs slug validation.
        • 
-
      • Bugfix: Lazy-translatable strings now properly serialized.
        • 
-
      • Bugfix: Browsable API now supports bootswatch styles properly.
        • 
-
      • Bugfix: HyperlinkedIdentityField now uses lookup_field kwarg.
        • 
-
      
-
      Note: Responses now correctly include an appropriate charset on the Content-Type header.  For example: application/json; charset=utf-8.  If you have tests that check the content type of responses, you may need to update these accordingly.
      
-
      2.3.3
      
-
      Date: 16th May 2013
      
-
        
-
      • Added SearchFilter
        • 
-
      • Added OrderingFilter
        • 
-
      • Added GenericViewSet
        • 
-
      • Bugfix: Multiple @action and @link methods now allowed on viewsets.
        • 
-
      • Bugfix: Fix API Root view issue with DjangoModelPermissions
        • 
-
      
-
      2.3.2
      
-
      Date: 8th May 2013
      
-
        
-
      • Bugfix: Fix TIME_FORMAT, DATETIME_FORMAT and DATE_FORMAT settings.
        • 
-
      • Bugfix: Fix DjangoFilterBackend issue, failing when used on view with queryset attribute.
        • 
-
      
-
      2.3.1
      
-
      Date: 7th May 2013
      
-
        
-
      • Bugfix: Fix breadcrumb rendering issue.
        • 
-
      
-
      2.3.0
      
-
      Date: 7th May 2013
      
-
        
-
      • ViewSets and Routers.
        • 
-
      • ModelSerializers support reverse relations in 'fields' option.
        • 
-
      • HyperLinkedModelSerializers support 'id' field in 'fields' option.
        • 
-
      • Cleaner generic views.
        • 
-
      • Support for multiple filter classes.
        • 
-
      • FileUploadParser support for raw file uploads.
        • 
-
      • DecimalField support.
        • 
-
      • Made Login template easier to restyle.
        • 
-
      • Bugfix: Fix issue with depth>1 on ModelSerializer.
        • 
-
      
-
      Note: See the 2.3 announcement for full details.
      
-
      
-
      2.2.x series
      
-
      2.2.7
      
-
      Date: 17th April 2013
      
-
        
-
      • Loud failure when view does not return a Response or HttpResponse.
        • 
-
      • Bugfix: Fix for Django 1.3 compatibility.
        • 
-
      • Bugfix: Allow overridden get_object() to work correctly.
        • 
-
      
-
      2.2.6
      
-
      Date: 4th April 2013
      
-
        
-
      • OAuth2 authentication no longer requires unnecessary URL parameters in addition to the token.
        • 
-
      • URL hyperlinking in browsable API now handles more cases correctly.
        • 
-
      • Long HTTP headers in browsable API are broken in multiple lines when possible.
        • 
-
      • Bugfix: Fix regression with DjangoFilterBackend not worthing correctly with single object views.
        • 
-
      • Bugfix: OAuth should fail hard when invalid token used.
        • 
-
      • Bugfix: Fix serializer potentially returning None object for models that define __bool__ or __len__.
        • 
-
      
-
      2.2.5
      
-
      Date: 26th March 2013
      
-
        
-
      • Serializer support for bulk create and bulk update operations.
        • 
-
      • Regression fix: Date and time fields return date/time objects by default.  Fixes regressions caused by 2.2.2.  See #743 for more details.
        • 
-
      • Bugfix: Fix 500 error is OAuth not attempted with OAuthAuthentication class installed.
        • 
-
      • Serializer.save() now supports arbitrary keyword args which are passed through to the object .save() method.  Mixins use force_insert and force_update where appropriate, resulting in one less database query.
        • 
-
      
-
      2.2.4
      
-
      Date: 13th March 2013
      
-
        
-
      • OAuth 2 support.
        • 
-
      • OAuth 1.0a support.
        • 
-
      • Support X-HTTP-Method-Override header.
        • 
-
      • Filtering backends are now applied to the querysets for object lookups as well as lists.  (Eg you can use a filtering backend to control which objects should 404)
        • 
-
      • Deal with error data nicely when deserializing lists of objects.
        • 
-
      • Extra override hook to configure DjangoModelPermissions for unauthenticated users.
        • 
-
      • Bugfix: Fix regression which caused extra database query on paginated list views.
        • 
-
      • Bugfix: Fix pk relationship bug for some types of 1-to-1 relations.
        • 
-
      • Bugfix: Workaround for Django bug causing case where Authtoken could be registered for cascade delete from User even if not installed.
        • 
-
      
-
      2.2.3
      
-
      Date: 7th March 2013
      
-
        
-
      • Bugfix: Fix None values for for DateField, DateTimeField and TimeField.
        • 
-
      
-
      2.2.2
      
-
      Date: 6th March 2013
      
-
        
-
      • Support for custom input and output formats for DateField, DateTimeField and TimeField.
        • 
-
      • Cleanup: Request authentication is no longer lazily evaluated, instead authentication is always run, which results in more consistent, obvious behavior.  Eg. Supplying bad auth credentials will now always return an error response, even if no permissions are set on the view.
        • 
-
      • Bugfix for serializer data being uncacheable with pickle protocol 0.
        • 
-
      • Bugfixes for model field validation edge-cases.
        • 
-
      • Bugfix for authtoken migration while using a custom user model and south.
        • 
-
      
-
      2.2.1
      
-
      Date: 22nd Feb 2013
      
-
        
-
      • Security fix: Use defusedxml package to address XML parsing vulnerabilities.
        • 
-
      • Raw data tab added to browsable API.  (Eg. Allow for JSON input.)
        • 
-
      • Added TimeField.
        • 
-
      • Serializer fields can be mapped to any method that takes no args, or only takes kwargs which have defaults.
        • 
-
      • Unicode support for view names/descriptions in browsable API.
        • 
-
      • Bugfix: request.DATA should return an empty QueryDict with no data, not None.
        • 
-
      • Bugfix: Remove unneeded field validation, which caused extra queries.
        • 
-
      
-
      Security note: Following the disclosure of security vulnerabilities in Python's XML parsing libraries, use of the XMLParser class now requires the defusedxml package to be installed.
      
-
      The security vulnerabilities only affect APIs which use the XMLParser class, by enabling it in any views, or by having it set in the DEFAULT_PARSER_CLASSES setting.  Note that the XMLParser class is not enabled by default, so this change should affect a minority of users.
      
-
      2.2.0
      
-
      Date: 13th Feb 2013
      
-
        
-
      • Python 3 support.
        • 
-
      • Added a post_save() hook to the generic views.
        • 
-
      • Allow serializers to handle dicts as well as objects.
        • 
-
      • Deprecate ManyRelatedField() syntax in favor of RelatedField(many=True)
        • 
-
      • Deprecate null=True on relations in favor of required=False.
        • 
-
      • Deprecate blank=True on CharFields, just use required=False.
        • 
-
      • Deprecate optional obj argument in permissions checks in favor of has_object_permission.
        • 
-
      • Deprecate implicit hyperlinked relations behavior.
        • 
-
      • Bugfix: Fix broken DjangoModelPermissions.
        • 
-
      • Bugfix: Allow serializer output to be cached.
        • 
-
      • Bugfix: Fix styling on browsable API login.
        • 
-
      • Bugfix: Fix issue with deserializing empty to-many relations.
        • 
-
      • Bugfix: Ensure model field validation is still applied for ModelSerializer subclasses with an custom .restore_object() method.
        • 
-
      
-
      Note: See the 2.2 announcement for full details.
      
-
      
-
      2.1.x series
      
-
      2.1.17
      
-
      Date: 26th Jan 2013
      
-
        
-
      • Support proper 401 Unauthorized responses where appropriate, instead of always using 403 Forbidden.
        • 
-
      • Support json encoding of timedelta objects.
        • 
-
      • format_suffix_patterns() now supports include style URL patterns.
        • 
-
      • Bugfix: Fix issues with custom pagination serializers.
        • 
-
      • Bugfix: Nested serializers now accept source='*' argument.
        • 
-
      • Bugfix: Return proper validation errors when incorrect types supplied for relational fields.
        • 
-
      • Bugfix: Support nullable FKs with SlugRelatedField.
        • 
-
      • Bugfix: Don't call custom validation methods if the field has an error.
        • 
-
      
-
      Note: If the primary authentication class is TokenAuthentication or BasicAuthentication, a view will now correctly return 401 responses to unauthenticated access, with an appropriate WWW-Authenticate header, instead of 403 responses.
      
-
      2.1.16
      
-
      Date: 14th Jan 2013
      
-
        
-
      • Deprecate django.utils.simplejson in favor of Python 2.6's built-in json module.
        • 
-
      • Bugfix: auto_now, auto_now_add and other editable=False fields now default to read-only.
        • 
-
      • Bugfix: PK fields now only default to read-only if they are an AutoField or if editable=False.
        • 
-
      • Bugfix: Validation errors instead of exceptions when serializers receive incorrect types.
        • 
-
      • Bugfix: Validation errors instead of exceptions when related fields receive incorrect types.
        • 
-
      • Bugfix: Handle ObjectDoesNotExist exception when serializing null reverse one-to-one
        • 
-
      
-
      Note: Prior to 2.1.16, The Decimals would render in JSON using floating point if simplejson was installed, but otherwise render using string notation.  Now that use of simplejson has been deprecated, Decimals will consistently render using string notation.  See ticket 582 for more details.
      
-
      2.1.15
      
-
      Date: 3rd Jan 2013
      
-
        
-
      • Added PATCH support.
        • 
-
      • Added RetrieveUpdateAPIView.
        • 
-
      • Remove unused internal save_m2m flag on ModelSerializer.save().
        • 
-
      • Tweak behavior of hyperlinked fields with an explicit format suffix.
        • 
-
      • Relation changes are now persisted in .save() instead of in .restore_object().
        • 
-
      • Bugfix: Fix issue with FileField raising exception instead of validation error when files=None.
        • 
-
      • Bugfix: Partial updates should not set default values if field is not included.
        • 
-
      
-
      2.1.14
      
-
      Date: 31st Dec 2012
      
-
        
-
      • Bugfix: ModelSerializers now include reverse FK fields on creation.
        • 
-
      • Bugfix: Model fields with blank=True are now required=False by default.
        • 
-
      • Bugfix: Nested serializers now support nullable relationships.
        • 
-
      
-
      Note: From 2.1.14 onwards, relational fields move out of the fields.py module and into the new relations.py module, in order to separate them from regular data type fields, such as CharField and IntegerField.
      
-
      This change will not affect user code, so long as it's following the recommended import style of from rest_framework import serializers and referring to fields using the style serializers.PrimaryKeyRelatedField.
      
-
      2.1.13
      
-
      Date: 28th Dec 2012
      
-
        
-
      • Support configurable STATICFILES_STORAGE storage.
        • 
-
      • Bugfix: Related fields now respect the required flag, and may be required=False.
        • 
-
      
-
      2.1.12
      
-
      Date: 21st Dec 2012
      
-
        
-
      • Bugfix: Fix bug that could occur using ChoiceField.
        • 
-
      • Bugfix: Fix exception in browsable API on DELETE.
        • 
-
      • Bugfix: Fix issue where pk was was being set to a string if set by URL kwarg.
        • 
-
      
-
      2.1.11
      
-
      Date: 17th Dec 2012
      
-
        
-
      • Bugfix: Fix issue with M2M fields in browsable API.
        • 
-
      
-
      2.1.10
      
-
      Date: 17th Dec 2012
      
-
        
-
      • Bugfix: Ensure read-only fields don't have model validation applied.
        • 
-
      • Bugfix: Fix hyperlinked fields in paginated results.
        • 
-
      
-
      2.1.9
      
-
      Date: 11th Dec 2012
      
-
        
-
      • Bugfix: Fix broken nested serialization.
        • 
-
      • Bugfix: Fix Meta.fields only working as tuple not as list.
        • 
-
      • Bugfix: Edge case if unnecessarily specifying required=False on read only field.
        • 
-
      
-
      2.1.8
      
-
      Date: 8th Dec 2012
      
-
        
-
      • Fix for creating nullable Foreign Keys with '' as well as None.
        • 
-
      • Added null=<bool> related field option.
        • 
-
      
-
      2.1.7
      
-
      Date: 7th Dec 2012
      
-
        
-
      • Serializers now properly support nullable Foreign Keys.
        • 
-
      • Serializer validation now includes model field validation, such as uniqueness constraints.
        • 
-
      • Support 'true' and 'false' string values for BooleanField.
        • 
-
      • Added pickle support for serialized data.
        • 
-
      • Support source='dotted.notation' style for nested serializers.
        • 
-
      • Make Request.user settable.
        • 
-
      • Bugfix: Fix RegexField to work with BrowsableAPIRenderer.
        • 
-
      
-
      2.1.6
      
-
      Date: 23rd Nov 2012
      
-
        
-
      • Bugfix: Unfix DjangoModelPermissions.  (I am a doofus.)
        • 
-
      
-
      2.1.5
      
-
      Date: 23rd Nov 2012
      
-
        
-
      • Bugfix: Fix DjangoModelPermissions.
        • 
-
      
-
      2.1.4
      
-
      Date: 22nd Nov 2012
      
-
        
-
      • Support for partial updates with serializers.
        • 
-
      • Added RegexField.
        • 
-
      • Added SerializerMethodField.
        • 
-
      • Serializer performance improvements.
        • 
-
      • Added obtain_token_view to get tokens when using TokenAuthentication.
        • 
-
      • Bugfix: Django 1.5 configurable user support for TokenAuthentication.
        • 
-
      
-
      2.1.3
      
-
      Date: 16th Nov 2012
      
-
        
-
      • Added FileField and ImageField.  For use with MultiPartParser.
        • 
-
      • Added URLField and SlugField.
        • 
-
      • Support for read_only_fields on ModelSerializer classes.
        • 
-
      • Support for clients overriding the pagination page sizes.  Use the PAGINATE_BY_PARAM setting or set the paginate_by_param attribute on a generic view.
        • 
-
      • 201 Responses now return a 'Location' header.
        • 
-
      • Bugfix: Serializer fields now respect max_length.
        • 
-
      
-
      2.1.2
      
-
      Date: 9th Nov 2012
      
-
        
-
      • Filtering support.
        • 
-
      • Bugfix: Support creation of objects with reverse M2M relations.
        • 
-
      
-
      2.1.1
      
-
      Date: 7th Nov 2012
      
-
        
-
      • Support use of HTML exception templates.  Eg. 403.html
        • 
-
      • Hyperlinked fields take optional slug_field, slug_url_kwarg and pk_url_kwarg arguments.
        • 
-
      • Bugfix: Deal with optional trailing slashes properly when generating breadcrumbs.
        • 
-
      • Bugfix: Make textareas same width as other fields in browsable API.
        • 
-
      • Private API change: .get_serializer now uses same instance and data ordering as serializer initialization.
        • 
-
      
-
      2.1.0
      
-
      Date: 5th Nov 2012
      
-
        
-
      • Serializer instance and data keyword args have their position swapped.
        • 
-
      • queryset argument is now optional on writable model fields.
        • 
-
      • Hyperlinked related fields optionally take slug_field and slug_url_kwarg arguments.
        • 
-
      • Support Django's cache framework.
        • 
-
      • Minor field improvements. (Don't stringify dicts, more robust many-pk fields.)
        • 
-
      • Bugfix: Support choice field in Browsable API.
        • 
-
      • Bugfix: Related fields with read_only=True do not require a queryset argument.
        • 
-
      
-
      API-incompatible changes: Please read this thread regarding the instance and data keyword args before updating to 2.1.0.
      
-
      
-
      2.0.x series
      
-
      2.0.2
      
-
      Date: 2nd Nov 2012
      
-
        
-
      • Fix issues with pk related fields in the browsable API.
        • 
-
      
-
      2.0.1
      
-
      Date: 1st Nov 2012
      
-
        
-
      • Add support for relational fields in the browsable API.
        • 
-
      • Added SlugRelatedField and ManySlugRelatedField.
        • 
-
      • If PUT creates an instance return '201 Created', instead of '200 OK'.
        • 
-
      
-
      2.0.0
      
-
      Date: 30th Oct 2012
      
-
        
-
      • Fix all of the things.  (Well, almost.)
        • 
-
      • For more information please see the 2.0 announcement.
        • 
-
      
-
      For older release notes, please see the GitHub repo.
      
+
      For older release notes, please see the version 2.x documentation.
      
 
 
 
      
diff --git a/topics/rest-hypermedia-hateoas/index.html b/topics/rest-hypermedia-hateoas/index.html
index 30e6c2b6c..3cd57775f 100644
--- a/topics/rest-hypermedia-hateoas/index.html
+++ b/topics/rest-hypermedia-hateoas/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
    • 
+                    Versioning
+                  
      • 
+                  
                   
    • 
                     Content negotiation
                   
      • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
    • 
+                    Internationalization
+                  
      • 
+                  
                   
    • 
                     AJAX, CSRF & CORS
                   
      • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
    • 
-                    2.0 Announcement
-                  
      • 
-                  
-                  
    • 
-                    2.2 Announcement
-                  
      • 
-                  
-                  
    • 
-                    2.3 Announcement
-                  
      • 
-                  
-                  
    • 
-                    2.4 Announcement
-                  
      • 
-                  
                   
    • 
                     3.0 Announcement
                   
      • 
                   
+                  
    • 
+                    3.1 Announcement
+                  
      • 
+                  
                   
    • 
                     Kickstarter Announcement
                   
      • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
    • 
-                    Credits
-                  
      • 
-                  
                 
    
               
                
diff --git a/topics/third-party-resources/index.html b/topics/third-party-resources/index.html
index c3ad6d8dc..f015640eb 100644
--- a/topics/third-party-resources/index.html
+++ b/topics/third-party-resources/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -512,6 +504,7 @@ You probably want to also tag the version now:
 
  • hawkrest - Provides Hawk HTTP Authorization.
    • 
 
  • djangorestframework-httpsignature - Provides an easy to use HTTP Signature Authentication mechanism.
    • 
 
  • djoser - Provides a set of views to handle basic actions such as registration, login, logout, password reset and account activation.
    • 
+
  • django-rest-auth - Provides a set of REST API endpoints for registration, authentication (including social media authentication), password reset, retrieve and update user details, etc.
    • 
 
 
    Permissions
    
 
               
                
diff --git a/tutorial/2-requests-and-responses/index.html b/tutorial/2-requests-and-responses/index.html
index cbc9c5965..df43617a2 100644
--- a/tutorial/2-requests-and-responses/index.html
+++ b/tutorial/2-requests-and-responses/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -479,7 +471,7 @@ def snippet_detail(request, pk):
         return Response(status=status.HTTP_204_NO_CONTENT)
 
    
 
    This should all feel very familiar - it is not a lot different from working with regular Django views.
    
-
    Notice that we're no longer explicitly tying our requests or responses to a given content type.  request.data can handle incoming json requests, but it can also handle yaml and other formats.  Similarly we're returning response objects with data, but allowing REST framework to render the response into the correct content type for us.
    
+
    Notice that we're no longer explicitly tying our requests or responses to a given content type.  request.data can handle incoming json requests, but it can also handle other formats.  Similarly we're returning response objects with data, but allowing REST framework to render the response into the correct content type for us.
    
 
    Adding optional format suffixes to our URLs
    
 
    To take advantage of the fact that our responses are no longer hardwired to a single content type let's add support for format suffixes to our API endpoints.  Using format suffixes gives us URLs that explicitly refer to a given format, and means our API will be able to handle URLs such as http://example.com/api/items/4/.json.
    
 
    Start by adding a format keyword argument to both of the views, like so.
    
diff --git a/tutorial/3-class-based-views/index.html b/tutorial/3-class-based-views/index.html
index 032638697..49488f2a6 100644
--- a/tutorial/3-class-based-views/index.html
+++ b/tutorial/3-class-based-views/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
diff --git a/tutorial/4-authentication-and-permissions/index.html b/tutorial/4-authentication-and-permissions/index.html
index e4e5fccc1..7b1007d67 100644
--- a/tutorial/4-authentication-and-permissions/index.html
+++ b/tutorial/4-authentication-and-permissions/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
diff --git a/tutorial/5-relationships-and-hyperlinked-apis/index.html b/tutorial/5-relationships-and-hyperlinked-apis/index.html
index 488bcb4a3..418c7851c 100644
--- a/tutorial/5-relationships-and-hyperlinked-apis/index.html
+++ b/tutorial/5-relationships-and-hyperlinked-apis/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -514,7 +506,7 @@ urlpatterns += [
 
    The list views for users and code snippets could end up returning quite a lot of instances, so really we'd like to make sure we paginate the results, and allow the API client to step through each of the individual pages.
    
 
    We can change the default list style to use pagination, by modifying our tutorial/settings.py file slightly.  Add the following setting:
    
 
    REST_FRAMEWORK = {
-    'PAGINATE_BY': 10
+    'PAGE_SIZE': 10
 }
 
    
 
    Note that settings in REST framework are all namespaced into a single dictionary setting, named 'REST_FRAMEWORK', which helps keep them well separated from your other project settings.
    
diff --git a/tutorial/6-viewsets-and-routers/index.html b/tutorial/6-viewsets-and-routers/index.html
index 254ab7913..3127cdf31 100644
--- a/tutorial/6-viewsets-and-routers/index.html
+++ b/tutorial/6-viewsets-and-routers/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
diff --git a/tutorial/quickstart/index.html b/tutorial/quickstart/index.html
index 80e368296..3d0f15b52 100644
--- a/tutorial/quickstart/index.html
+++ b/tutorial/quickstart/index.html
@@ -188,6 +188,10 @@
                     Pagination
                   
                   
+                  
  • 
+                    Versioning
+                  
    • 
+                  
                   
  • 
                     Content negotiation
                   
    • 
@@ -231,6 +235,10 @@
                     Documenting your API
                   
                   
+                  
  • 
+                    Internationalization
+                  
    • 
+                  
                   
  • 
                     AJAX, CSRF & CORS
                   
    • 
@@ -259,26 +267,14 @@
                     Project management
                   
                   
-                  
  • 
-                    2.0 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.2 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.3 Announcement
-                  
    • 
-                  
-                  
  • 
-                    2.4 Announcement
-                  
    • 
-                  
                   
  • 
                     3.0 Announcement
                   
    • 
                   
+                  
  • 
+                    3.1 Announcement
+                  
    • 
+                  
                   
  • 
                     Kickstarter Announcement
                   
    • 
@@ -287,10 +283,6 @@
                     Release Notes
                   
                   
-                  
  • 
-                    Credits
-                  
    • 
-                  
                 
               
                
@@ -496,7 +488,7 @@ urlpatterns = [
 
 REST_FRAMEWORK = {
     'DEFAULT_PERMISSION_CLASSES': ('rest_framework.permissions.IsAdminUser',),
-    'PAGINATE_BY': 10
+    'PAGE_SIZE': 10
 }
 
    
 
    Okay, we're done.