Add back the graph artifact docs for the container - #7752
Style Review Completed
The pull request has 10 style issues.
Duration: 546ms
PR URL: #7752
Review Comments: The AI has posted 10 inline comments with suggestions
Summary of changes:
The documentation has been updated to reflect the following changes: headings in how-to articles now use the imperative mood; the present tense is used instead of the future tense to describe an action; the number of items is no longer specified when introducing a list; and unordered lists are used for non-sequential options, with list items using the imperative mood and consistent ending punctuation.
Annotations
Check warning on line 136 in docs/source/routing/self-hosted/containerization/docker-router-only.mdx
apollo-librarian / AI Style Review
docs/source/routing/self-hosted/containerization/docker-router-only.mdx#L136
Avoid specifying the number of items when introducing a list.
```suggestion
If you don't want to automatically update your supergraph via [Apollo Uplink](/federation/managed-federation/uplink/), or you don't have connectivity to access Apollo Uplink from your environment, you can use one of the following methods:
```
Check warning on line 138 in docs/source/routing/self-hosted/containerization/docker-router-only.mdx
apollo-librarian / AI Style Review
docs/source/routing/self-hosted/containerization/docker-router-only.mdx#L138
Headings in how-to articles should use the imperative mood.
```suggestion
### Use a local supergraph file
```
Check warning on line 151 in docs/source/routing/self-hosted/containerization/docker-router-only.mdx
apollo-librarian / AI Style Review
docs/source/routing/self-hosted/containerization/docker-router-only.mdx#L151
Headings in how-to articles should use the imperative mood.
```suggestion
### Use an OCI image reference
```
Check warning on line 163 in docs/source/routing/self-hosted/containerization/docker-router-only.mdx
apollo-librarian / AI Style Review
docs/source/routing/self-hosted/containerization/docker-router-only.mdx#L163
Use the present tense instead of the future tense to describe an action.
```suggestion
When using this option, the router fetches the schema from the specified OCI image instead of using Apollo Uplink.
```
Check warning on line 93 in docs/source/routing/self-hosted/containerization/docker.mdx
apollo-librarian / AI Style Review
docs/source/routing/self-hosted/containerization/docker.mdx#L93
Headings in how-to articles should use the imperative mood.
```suggestion
## Specify the supergraph
```
Check warning on line 95 in docs/source/routing/self-hosted/containerization/docker.mdx
apollo-librarian / AI Style Review
docs/source/routing/self-hosted/containerization/docker.mdx#L95
Avoid specifying the number of items when introducing a list.
```suggestion
If you don't want to automatically update your supergraph via [Apollo Uplink](/federation/managed-federation/uplink/), or you don't have connectivity to access Apollo Uplink from your environment, you can use one of the following methods:
```
Check warning on line 97 in docs/source/routing/self-hosted/containerization/docker.mdx
apollo-librarian / AI Style Review
docs/source/routing/self-hosted/containerization/docker.mdx#L97
Use an unordered list for options that are not sequential steps. List items should also use the imperative mood for consistency.
```suggestion
- Use a local supergraph file, as documented in the [Configuring using local files](#configuring-using-local-files) section.
```
Check warning on line 98 in docs/source/routing/self-hosted/containerization/docker.mdx
apollo-librarian / AI Style Review
docs/source/routing/self-hosted/containerization/docker.mdx#L98
Use an unordered list for non-sequential options and ensure list items are structurally consistent with each other (imperative mood and ending punctuation).
```suggestion
- Use an [OCI image reference](#using-an-oci-image-reference).
```
Check warning on line 100 in docs/source/routing/self-hosted/containerization/docker.mdx
apollo-librarian / AI Style Review
docs/source/routing/self-hosted/containerization/docker.mdx#L100
Headings in how-to articles should use the imperative mood.
```suggestion
### Use an OCI image reference
```
Check warning on line 112 in docs/source/routing/self-hosted/containerization/docker.mdx
apollo-librarian / AI Style Review
docs/source/routing/self-hosted/containerization/docker.mdx#L112
Use the present tense instead of the future tense. The lead-in to the link is also more direct.
```suggestion
When using this option, the router fetches the schema from the specified OCI image instead of using Apollo Uplink. For more information on graph artifacts, see the [router CLI options documentation](/docs/graphos/routing/configuration/cli#command-line-options).
```