address style comments

Author: nicholascioli

docs/source/command-reference.mdx

@@ -95,10 +95,10 @@ apollo-mcp-server [OPTIONS] <PATH/TO/CONFIG/FILE>
 
 ### CLI options
 
-| Option          | Description                                                |
-| :-------------- | :--------------------------------------------------------- |
-| `-h, --help`    | Print help (see a summary with `-h`).                      |
-| `-V, --version` | Print version                                              |
+| Option          | Description               |
+| :-------------- | :------------------------ |
+| `-h, --help`    | Print help information    |
+| `-V, --version` | Print version information |
 
 ### Config options
 
@@ -148,15 +148,15 @@ These fields are under the top-level `introspection` key.
 
 These fields are under the top-level `logging` key.
 
-| Option  | Type                                                | Default  | Description                      |
-|--:------|--:--------------------------------------------------|--:-------|--:-------------------------------|
-| `level` | `oneOf ["trace", "debug", "info", "warn", "error"]` | `"info"` | The log level to use for tracing |
+| Option  | Type                                                | Default  | Description                     |
+|--:------|--:--------------------------------------------------|--:-------|--:------------------------------|
+| `level` | `oneOf ["trace", "debug", "info", "warn", "error"]` | `"info"` | The minimum log level to record |
 
 
 #### Operation source configuration
 
-These fields are under the top-level `operations` key. There are multiple valid choices for this key based on the `source` key
-with the default being `infer`.
+These fields are under the top-level `operations` key. The available fields depend on the value of the nested `source` key.
+The default value for `source` is `"infer"`.
 
 | Source             | Option   | Type             | Default | Description                                                                                           |
 |--:-----------------|--:-------|--:---------------|--:------|--:----------------------------------------------------------------------------------------------------|
@@ -180,13 +180,13 @@ These fields are under the top-level `overrides` key.
 | `disable_type_description`   | `bool`                              | `false`  | Disable type descriptions to save on context-window space                                                                        |
 | `disable_schema_description` | `bool`                              | `false`  | Disable schema descriptions to save on context-window space                                                                      |
 | `enable_explorer`            | `bool`                              | `false`  | Expose a tool that returns the URL to open a GraphQL operation in Apollo Explorer. Note: This requires a GraphOS graph reference |
-| `mutation_mode`              | `oneOf ["none", "explicit", "all"]` | `"none"` | Set the mutation mode access level for the MCP server                                                                            |
+| `mutation_mode`              | `oneOf ["none", "explicit", "all"]` | `"none"` | Defines the mutation access level for the MCP server                                                                             |
 
 
 #### Schema source configuration
 
-These fields are under the top-level `schema` key. There are multiple valid choices for this key based on the `source` key
-with the default being `uplink`.
+These fields are under the top-level `schema` key. The available fields depend on the value of the nested `source` key.
+The default value for `source` is `"uplink"`.
 
 | Source | Option   | Type       | Default | Description                                                                         |
 |--:-----|--:-------|--:---------|--:------|--:----------------------------------------------------------------------------------|
@@ -197,8 +197,8 @@ with the default being `uplink`.
 
 #### Transport configuration
 
-These fields are under the top-level `transport` key. There are multiple valid choices for this key based on the `type` key
-with the default being `stdio`.
+These fields are under the top-level `transport` key. The available fields depend on the value of the nested `type` key.
+The default value for `type` is `"stdio"`.
 
 | Type           | Option    | Type                | Default     | Description                                                                                                                   |
 |--:-------------|--:--------|--:------------------|--:----------|--:----------------------------------------------------------------------------------------------------------------------------|
@@ -219,6 +219,6 @@ Running `rover dev --mcp` starts an MCP Server. Additional options, `--mcp*`, di
 
 The mapping of `rover dev` options to MCP Server options:
 
-| `rover dev` option                                    | Equivalent MCP Server option                          |
-| :---------------------------------------------------- | :---------------------------------------------------- |
-| `--mcp-config <PATH/TO/CONFIG>`                       | `<PATH/TO/CONFIG>`                                    |
+| `rover dev` option              | Equivalent MCP Server option | Description                               |
+|-:-------------------------------|-:----------------------------|-------------------------------------------|
+| `--mcp-config <PATH/TO/CONFIG>` | `<PATH/TO/CONFIG>`           | Path to the MCP server configuration file |