diff --git a/docs/usage.md b/docs/usage.md index ef27d2b7..1a2cb195 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -1056,6 +1056,11 @@ The `prefetch_related` case will issue 4 queries, but they will be small and fas ## Generating an OpenAPI Specification (OAS) 3.0 schema document +DRF has a [OAS schema functionality](https://www.django-rest-framework.org/api-guide/schemas/) to generate an +[OAS 3.0 schema](https://www.openapis.org/) as a YAML or JSON file. + +DJA extends DRF's schema support to generate an OAS schema in the JSON:API format. + --- **Deprecation notice:** @@ -1070,11 +1075,6 @@ As a full-fledged replacement, we recommend the [drf-spectacular-json-api] packa --- -DRF has a [OAS schema functionality](https://www.django-rest-framework.org/api-guide/schemas/) to generate an -[OAS 3.0 schema](https://www.openapis.org/) as a YAML or JSON file. - -DJA extends DRF's schema support to generate an OAS schema in the JSON:API format. - ### AutoSchema Settings In order to produce an OAS schema that properly represents the JSON:API structure