Placeholder for 3.12 release

[lovelydinosaur]

Basic structure at the moment looks like this...

(Tho there's a whole host of smaller line items)

Need to flesh this out with examples for everything to give some better context throughout, and also figure out what other PRs ought to make the 3.12 cutoff.

Django REST framework 3.12

Schema generation improvements

Grouping operations with tags.

https://www.django-rest-framework.org/api-guide/schemas/#grouping-operations-with-tags

Customizing the operation ID.

https://www.django-rest-framework.org/api-guide/schemas/#operationid

Support OpenAPI components.

https://www.django-rest-framework.org/api-guide/schemas/#components

More Public API

• get_path_parameters
• get_pagination_parameters
• get_filter_parameters
• get_request_body
• get_responses
• get_serializer
• get_paginator
• map_serializer
• map_field
• map_choice_field
• map_field_validators
• allows_filters.

See the schema docs.

Support for JSONField.

Django 3.1 deprecated the existing django.contrib.postgres.fields.JSONField
in favour of a new database-agnositic JSONField.

REST framework 3.12 now supports this new model field, and ModelSerializer
classes will correctly map the model field.

SearchFilter improvements

There are a couple of significant improvements to the SearchFilter class.

Support for nested search within JSONField and HStoreField

TODO Example to give better context.

Support for searching against fields created using annotate

TODO Example to give better context.