Add a dedicated extensions section to the docs (#3931)

* Add a dedicated extensions section to the docs

* Fix typos

Author: DoctorJohn

docs/README.md

@@ -41,8 +41,6 @@ title: Strawberry docs
 - [Schema codegen](./codegen/schema-codegen.md)
 - [Query codegen](./codegen/query-codegen.md)
 
-## [Extensions](./extensions)
-
 ## Guides
 
 - [Accessing parent data](./guides/accessing-parent-data.md)
@@ -52,8 +50,6 @@ title: Strawberry docs
 - [Federation](./guides/federation.md)
 - [Federation V1](./guides/federation-v1.md)
 - [Relay](./guides/relay.md)
-- [Custom extensions](./guides/custom-extensions.md)
-- [Field extensions](./guides/field-extensions.md)
 - [File upload](./guides/file-upload.md)
 - [Pagination](./guides/pagination/overview.md)
   - [Implementing Offset Pagination](./guides/pagination/offset-based.md)
@@ -65,6 +61,12 @@ title: Strawberry docs
 - [Schema export](./guides/schema-export.md)
 - [Convert to dictionary](./guides/convert-to-dictionary.md)
 
+## Extensions
+
+- [Introduction](./extensions)
+- [Schema extensions](./guides/custom-extensions.md)
+- [Field extensions](./guides/field-extensions.md)
+
 ## Editor integration
 
 - [Mypy](./editors/mypy.md)

docs/extensions.md

@@ -6,10 +6,14 @@ title: Extensions
 
 Extensions allow you, as an application developer, to customise the GraphQL
 execution flow based on your needs. Strawberry provides multiple built in
-extensions that allow you extend the capability of your GraphQL server.
+extensions that allow you to extend the capability of your GraphQL server.
 
-If you can't find what you need here you can also build your own custom
-extension based on a standard interface. More details
-[here](/docs/guides/custom-extensions).
+If you can't find what you need among the
+[built-in extensions](#built-in-extensions), you can also build your own custom
+extension based on a standard interface. Check out the
+[schema extensions](./guides/custom-extensions.md) and
+[field extensions](./guides/field-extensions.md) guides to find out more.
+
+## Built-in extensions
 
 <ExtensionsList />

docs/guides/custom-extensions.md

@@ -1,14 +1,14 @@
 ---
-title: Custom extensions
+title: Schema extensions
 ---
 
-# Custom extensions
+# Schema extensions
 
-Strawberry provides support for adding extensions. Extensions can be used to
-hook into different parts of the GraphQL execution and to provide additional
-results to the GraphQL response.
+Strawberry provides support for adding extensions to your schema. Schema
+extensions can be used to hook into different parts of the GraphQL execution and
+to provide additional results to the GraphQL response.
 
-To create a custom extensions you can use extend from our `SchemaExtension` base
+To create a custom extension you can extend from our `SchemaExtension` base
 class:
 
 ```python