docs: update note on EOL for AS4#8215
Open
mabuyo wants to merge 1 commit into
Open
Apollo Librarian / AI Style Review
succeeded
May 21, 2026 in 27s
Style Review Completed
The pull request has 1 style issue.
Duration: 2264ms
PR URL: #8215
Review Log: View detailed log
Review Comments: The AI has posted 1 inline comment with suggestions
Summary of changes:
The pull request updates the documentation style guide with the following changes: for 'framing-apollo-products', it suggests using simpler terms like 'move' or 'adopt' instead of 'migration'; in 'framing', 'Apollo' replaces 'We' for clarity; for 'structural-elements', <Caution> admonitions are now required for end-of-life warnings; 'text-formatting' now mandates descriptive noun phrases for link text; 'verb-tense-and-voice' requires active voice for Apollo Server 4 status; the 'voice' section encourages a more authoritative tone; and 'word-and-symbol-usage' restricts the use of 'since' to time-based contexts only.
Annotations
Check warning on line 11 in docs/source/index.mdx
apollo-librarian / AI Style Review
docs/source/index.mdx#L11
**Framing Apollo Products**: Use simpler language like 'move' or 'adopt' instead of 'upgrade' or 'migration' where possible.
**Framing**: Use 'Apollo' instead of 'We' to clearly identify the entity making the recommendation.
**Structural Elements**: Use a <Caution> admonition for highly important information like end-of-life warnings instead of a blockquote.
**Text Formatting**: Avoid using vague phrases like 'previous versions' as link text; use a rich noun phrase instead.
**Verb Tense and Voice**: Use active voice to describe the status of Apollo Server 4.
**Voice**: Use a more authoritative and encouraging tone rather than just recommending.
**Word and Symbol Usage**: Avoid using 'since' as a synonym for 'because'.
```suggestion
> We recommend that all users of [previous versions](./previous-versions) of Apollo Server move to Apollo Server 5 as soon as possible. Apollo Server 4 has been end-of-life since January 26, 2026. Refer to the [adoption guide for v4](/apollo-server/migration/) or [v3](/apollo-server/migration-from-v3/).
```
Loading