address AI Librarian style comments

Author: mabuyo

docs/source/command-reference.mdx

@@ -295,7 +295,7 @@ transport:
     - profile
 ```
 
-## Using `rover dev`
+## Run a local graph with MCP server using `rover dev`
 
 You can use the [`rover dev`](/rover/commands/dev) command of Rover CLI `v0.35` or later to run an Apollo MCP Server instance for local development alongside your local graph. Use the `--mcp` flag to start an MCP server and provide an optional configuration file.
 

docs/source/guides/index.mdx

@@ -186,26 +186,26 @@ introspection:
 apollo-mcp-server <path to the preceding config>
 ```
 
-## Authorization
+## Set up authorization
 
 The Apollo MCP server supports authorizing clients (e.g. LLMs) in accordance with [the MCP specification](https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization).
 
 Depending on whether you are connecting internal agents (first-party) or external agents (third-party, such as Claude, ChatGPT, or other public AI assistants), the steps to configure authorization will differ.
 
-For internal / first-party agents, you will need:
+For internal (first-party) agents, you need:
 
-1. An [OAuth 2.1-compliant](https://oauth.net/2.1/) Identity Provider (for example, your own in-house IdP or a third-party IdP such as Auth0, Okta, Keycloak, etc).
-2. An Apollo Router [configured to use JWT authentication](/graphos/routing/security/jwt).
+1. An [OAuth 2.1-compliant](https://oauth.net/2.1/) Identity Provider (for example, your own in-house IdP or a third-party IdP such as Auth0, Okta, Keycloak, etc)
+2. An Apollo Router [configured to use JWT authentication](/graphos/routing/security/jwt)
 
-For external / third-party agents, in addition to the above, you will also need:
+For external (third-party) agents, in addition to the preceding items, you also need:
 
-3. A configuration file for the MCP server that [defines the `auth` settings](/apollo-mcp-server/command-reference#auth).
+3. A configuration file for the MCP server that [defines the `auth` settings](/apollo-mcp-server/command-reference#auth)
 
-### Example: Auth configuration with Auth0 and third-party agents
+### Example: Configure authentication with Auth0 and third-party agents
 
 Here is an example of how to set up Apollo MCP Server and Apollo Router, with Auth0 as the Identity Provider for external/third-party access.
 
-1. [Set up an Auth0 API](https://auth0.com/docs/get-started/auth0-overview/set-up-apis). You'll need your Auth0 domain for the next step.
+1. [Set up an Auth0 API](https://auth0.com/docs/get-started/auth0-overview/set-up-apis). You need your Auth0 domain for the next step.
 2. Configure the Apollo Router to [use JWT authentication](/graphos/routing/security/jwt):
 
     This example router configuration enforces authentication on all requests and uses the JWKS endpoint provided by Auth0 to validate JWTs:
@@ -222,7 +222,7 @@ Here is an example of how to set up Apollo MCP Server and Apollo Router, with Au
 
 3. Configure the MCP server to use the same Auth0 instance for authentication.
 
-    This example MCP server configuration enforces authentication on all requests, delegating the actual login process to our previously configured Auth0 instance.
+    This example MCP server configuration enforces authentication on all requests, delegating the actual login process to your previously-configured Auth0 instance.
 
     ```yaml title="Example MCP config for authentication"
     transport: