Skip to content

Add back the graph artifact docs for the container - #7752

Merged
mabuyo merged 2 commits into
devfrom
jl-apply-back-registry-container-docs
Jun 25, 2025
Merged

Add back the graph artifact docs for the container#7752
mabuyo merged 2 commits into
devfrom
jl-apply-back-registry-container-docs

Add changeset

f140475
Select commit
Loading
Failed to load commit list.
Apollo Librarian / AI Style Review succeeded Jun 25, 2025 in 52s

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.

⚠️ This review and suggested changes are AI-generated. Please use common sense when accepting these suggestions, as they may not always be accurate or appropriate for your specific context.

Annotations

Check warning on line 136 in docs/source/routing/self-hosted/containerization/docker-router-only.mdx

See this annotation in the file changed.

@apollo-librarian 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

See this annotation in the file changed.

@apollo-librarian 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

See this annotation in the file changed.

@apollo-librarian 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

See this annotation in the file changed.

@apollo-librarian 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

See this annotation in the file changed.

@apollo-librarian 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

See this annotation in the file changed.

@apollo-librarian 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

See this annotation in the file changed.

@apollo-librarian 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

See this annotation in the file changed.

@apollo-librarian 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

See this annotation in the file changed.

@apollo-librarian 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

See this annotation in the file changed.

@apollo-librarian 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).
```