mirror of
https://github.com/encode/django-rest-framework.git
synced 2024-11-10 19:56:59 +03:00
Docs tweaks
This commit is contained in:
parent
fe5db41949
commit
b3477b3b6c
|
@ -100,7 +100,7 @@ General guides to using REST framework.
|
|||
|
||||
* [CSRF][csrf]
|
||||
* [Browser enhancements][browser-enhancements]
|
||||
* [Working with the Browsable API][browsableapi]
|
||||
* [The Browsable API][browsableapi]
|
||||
* [REST, Hypermedia & HATEOAS][rest-hypermedia-hateoas]
|
||||
* [Contributing to REST framework][contributing]
|
||||
* [2.0 Migration Guide][migration]
|
||||
|
|
|
@ -74,7 +74,7 @@
|
|||
<ul class="dropdown-menu">
|
||||
<li><a href="{{ base_url }}/topics/csrf{{ suffix }}">Working with AJAX and CSRF</a></li>
|
||||
<li><a href="{{ base_url }}/topics/browser-enhancements{{ suffix }}">Browser enhancements</a></li>
|
||||
<li><a href="{{ base_url }}/topics/browsable-api{{ suffix }}">Working with the Browsable API</a></li>
|
||||
<li><a href="{{ base_url }}/topics/browsable-api{{ suffix }}">The Browsable API</a></li>
|
||||
<li><a href="{{ base_url }}/topics/rest-hypermedia-hateoas{{ suffix }}">REST, Hypermedia & HATEOAS</a></li>
|
||||
<li><a href="{{ base_url }}/topics/contributing{{ suffix }}">Contributing to REST framework</a></li>
|
||||
<li><a href="{{ base_url }}/topics/migration{{ suffix }}">2.0 Migration Guide</a></li>
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
# Working with the Browsable API
|
||||
# The Browsable API
|
||||
|
||||
API may stand for Application *Programming* Interface, but humans have to be able to read the APIs, too; someone has to do the programming. Django REST Framework supports generating human-friendly HTML output for each resource when the `HTML` format is requested. These pages allow for easy browsing of resources, as well as forms for submitting data to the resources using `POST`, `PUT`, and `DELETE`.
|
||||
|
||||
|
|
|
@ -1,5 +1,9 @@
|
|||
# 2.0 Migration Guide
|
||||
|
||||
> Move fast and break things
|
||||
>
|
||||
> — Mark Zuckerberg, [the Hacker Way][cite].
|
||||
|
||||
REST framework 2.0 introduces a radical redesign of the core components, and a large number of backwards breaking changes.
|
||||
|
||||
### Serialization redesign.
|
||||
|
@ -21,7 +25,7 @@ REST framework 2.0's request-response cycle is now much less complex.
|
|||
* Responses inherit from `SimpleTemplateResponse`, allowing rendering to be delegated to the response, not handled by the view.
|
||||
* Requests extend the regular `HttpRequest`, allowing authentication and parsing to be delegated to the request, not handled by the view.
|
||||
|
||||
### Renamed attribnutes & classes.
|
||||
### Renamed attributes & classes.
|
||||
|
||||
Various attributes and classes have been renamed in order to fit in better with Django's conventions.
|
||||
|
||||
|
@ -82,4 +86,4 @@ Let's start to re-write this for REST framework 2.0.
|
|||
model = Comment
|
||||
fields = ('username', 'comment', 'created', 'rating', 'url', 'blogpost')
|
||||
|
||||
|
||||
[cite]: http://www.wired.com/business/2012/02/zuck-letter/
|
||||
|
|
Loading…
Reference in New Issue
Block a user