aboutsummaryrefslogtreecommitdiffstats
path: root/docs/topics/rest-hypermedia-hateoas.md
diff options
context:
space:
mode:
authorTom Christie2012-10-17 13:51:15 +0100
committerTom Christie2012-10-17 13:51:22 +0100
commitb5daa40852fb5936e6cddb31ecda5c4b40175cd4 (patch)
treeed633872ab23df44eb39aa95750e6103a47587f4 /docs/topics/rest-hypermedia-hateoas.md
parent75ebf895ac3dce4b0e4fbe569fc683e16b788a31 (diff)
downloaddjango-rest-framework-b5daa40852fb5936e6cddb31ecda5c4b40175cd4.tar.bz2
Docs tweaks
Diffstat (limited to 'docs/topics/rest-hypermedia-hateoas.md')
-rw-r--r--docs/topics/rest-hypermedia-hateoas.md4
1 files changed, 2 insertions, 2 deletions
diff --git a/docs/topics/rest-hypermedia-hateoas.md b/docs/topics/rest-hypermedia-hateoas.md
index dda10eb4..8b0309b9 100644
--- a/docs/topics/rest-hypermedia-hateoas.md
+++ b/docs/topics/rest-hypermedia-hateoas.md
@@ -24,13 +24,13 @@ For a more thorough background, check out Klabnik's [Hypermedia API reading list
REST framework is an agnositic Web API toolkit. It does help guide you towards building well-connected APIs, and makes it easy to design appropriate media types, but it does not strictly enforce any particular design style.
-## What REST framework *does* provide.
+## What REST framework provides.
It is self evident that REST framework makes it possible to build Hypermedia APIs. The browseable API that it offers is built on HTML - the hypermedia language of the web.
REST framework also includes [serialization] and [parser]/[renderer] components that make it easy to build appropriate media types, [hyperlinked relations][fields] for building well-connected systems, and great support for [content negotiation][conneg].
-## What REST framework *doesn't* provide.
+## What REST framework doesn't provide.
What REST framework doesn't do is give you is machine readable hypermedia formats such as [Collection+JSON][collection] or HTML [microformats] by default, or the ability to auto-magically create fully HATEOAS style APIs that include hypermedia-based form descriptions and semantically labelled hyperlinks. Doing so would involve making opinionated choices about API design that should really remain outside of the framework's scope.