From 0cbc14a059541bce319d23c0b1e59c861d35e4ce Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Thu, 5 Oct 2017 21:22:49 +0200 Subject: [PATCH] Begin releae anouncement --- docs/topics/3.7-announcement.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 docs/topics/3.7-announcement.md diff --git a/docs/topics/3.7-announcement.md b/docs/topics/3.7-announcement.md new file mode 100644 index 000000000..02b76fa53 --- /dev/null +++ b/docs/topics/3.7-announcement.md @@ -0,0 +1,29 @@ + +# Django REST framework 3.7 + +The 3.7 release focuses on improvements to schema generation and interactive API +documentation. + +## Per-view customisation of schema generation. + +`APIView` now exposes a `schema` attribute. By default this is an instance of +`rest_framwork.schemas.AutoSchema`. You can subclass this to customise schema +generation on a per-view basis, whilst maintaining the default schema generation +elsewhere. + +See [Schema Docs][schema-docs] for full details. + +[schema-docs]: ../api-guide/schemas.md + +## Deprecations + +### `exclude_from_schema` + +Both `APIView.exclude_from_schema` and the `exclude_from_schema` argument to the +`@api_view` decorator and now `PendingDeprecation`. + +For `APIView` set `schema = None`. For function based views use the `@schema` +decorator passing `None`. + + +