From 3bc40e4e400a119b54c0fed3f1149d32a27245a9 Mon Sep 17 00:00:00 2001 From: Joseph Caudle Date: Sat, 29 Nov 2025 11:24:00 -0500 Subject: [PATCH 1/5] docs: Point Federation Version Support doc to Changelog In order to reduce the need for multiple updates over time, this change removes a table (which had become outdated) in favor of a link to the official changelog and how to use it for the same purpose the table had served. --- .../routing/federation-version-support.mdx | 409 +----------------- 1 file changed, 3 insertions(+), 406 deletions(-) diff --git a/docs/source/routing/federation-version-support.mdx b/docs/source/routing/federation-version-support.mdx index a9960e5bc1..3fae053e41 100644 --- a/docs/source/routing/federation-version-support.mdx +++ b/docs/source/routing/federation-version-support.mdx @@ -1,13 +1,10 @@ --- title: Federation Version Support subtitle: Check router version compatibility with Apollo Federation versions -description: This reference shows which version of Apollo Federation each GraphOS Router and Apollo Router Core release is compiled against. Ensure your router uses at least the listed federation version. +description: This reference explains how to check that your router uses at least the minimum required federation version. --- -The GraphOS Router and Apollo Router Core support supergraph schemas that are generated via Apollo Federation 2.x [composition](/federation/federated-types/composition/). This composition algorithm is usually performed by one of the following: - -* Apollo GraphOS (for supergraphs that use [managed federation](/federation/managed-federation/overview/)) -* The Rover CLI (for _non_-managed supergraphs) +The GraphOS Router and Apollo Router Core support supergraph schemas that are generated via Apollo Federation 2.x [composition](/federation/federated-types/composition/). This composition algorithm can be performed by Apollo GraphOS Studio, the Rover CLI, or the Apollo GraphOS Platform API. Apollo Federation is an evolving project, and its composition algorithm regularly receives new features and bug fixes. @@ -19,407 +16,7 @@ Update your router regularly to the latest stable version to ensure that it full ## Support table -The table below shows which version of federation each router release is compiled against. Make sure that your router's federation version is _at least_ as recent as the version used to compose your supergraph schema. - - - -**Avoid router versions marked with ⚠️.** These versions include bugs described in the [changelog](https://github.com/apollographql/router/blob/main/CHANGELOG.md). - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Router versionFederation version
- v2.0.0 and later (see latest releases) - - 2.9.3 -
- v1.57.0 - v1.60.0 - - 2.9.3 -
- v1.56.0 - - 2.9.2 -
- v1.55.0 - - 2.9.1 -
- v1.52.1 - v1.53.0 - - 2.9.0 -
- v1.52.1 - - 2.8.5 -
- v1.49.0 - v1.52.0 - - 2.8.1 -
- v1.48.0 - v1.49.0 - - 2.8.0 -
- v1.46.0 - v1.47.0 - - 2.7.5 -
- v1.45.1 - - 2.7.2 -
- ⚠️ v1.45.0 - - 2.7.2 -
- v1.39.0 - v1.44.0 - - 2.7.1 -
- v1.38.0 - - 2.6.3 -
- v1.36.0 - v1.37.0 - - 2.6.2 -
- v1.35.0 - - 2.6.1 -
- v1.34.1 - - 2.5.7 -
- v1.33.0 - v1.34.0 - - 2.5.5 -
- v1.30.0 - v1.32.0 - - 2.5.4 -
- ️v1.29.1 - - 2.5.3 -
- ⚠️ v1.29.0 - - 2.5.3 -
- ⚠️ v1.28.0 - v1.28.1 - - 2.5.1 -
- v1.25.0 - v1.27.0 - - 2.4.10 -
- v1.24.0 - - 2.4.9 -
- v1.21.0 - v1.23.0 - - 2.4.8 -
- v1.20.0 - - 2.4.7 -
- ️⚠️ v1.19.1 - - 2.4.6 -
- ⚠️ v1.19.0 - - 2.4.5 -
- v1.16.0 - v1.18.1 - - 2.4.2 -
- v1.15.0 - v1.15.1 - - 2.4.1 -
- v1.13.1 - v1.14.0 - - 2.4.0 -
- v1.11.0 - v1.13.0 - - 2.3.2 -
- v1.10.2 - v1.10.3 - - 2.3.1 -
- ⚠️ v1.10.1 - - 2.3.1 -
- ⚠️ v1.10.0 - - 2.3.0 -
- v1.6.0 - v1.9.0 - - 2.2.2 -
- v1.2.1 - v1.5.0 - - 2.1.4 -
- v1.0.0 - v1.2.0 - - 2.1.3 -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Router versionFederation version
- v1.0.0-rc.1 and v1.0.0 - - 2.1.2-alpha.2 -
- v1.0.0-rc.0 - - 2.1.2-alpha.1 -
- v1.0.0-alpha.3 - - 2.1.2-alpha.0 -
- v1.0.0-alpha.1 - v1.0.0-alpha.2 - - 2.1.1 -
- v0.16.0 - v1.0.0-alpha.0 - - 2.1.0-alpha.4 -
- v0.9.0 – v0.15.1 - - 2.0.2 -
- v0.1.0-preview.5 – v0.1.0-preview.7 - - 2.0.1 -
- v0.1.0-preview.4 - - 2.0.0 -
- v0.1.0-preview.3 - - 2.0.0-preview.7 -
- - +To ensure your router's federation version is supported, check the [Apollo Federation Changelog](graphos/schema-design/federated-schemas/reference/versions). Make sure that your router's federation version is _at least_ as recent as the version used to compose your supergraph schema. ## Federation 1 support From 757bc97ea5f660e54a10cc9128b150646f735492 Mon Sep 17 00:00:00 2001 From: Joseph Caudle Date: Sat, 29 Nov 2025 11:33:03 -0500 Subject: [PATCH 2/5] Revise "Support Table" header Updated section heading since there is no "support table" anymore. --- docs/source/routing/federation-version-support.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/routing/federation-version-support.mdx b/docs/source/routing/federation-version-support.mdx index 3fae053e41..9e46b96527 100644 --- a/docs/source/routing/federation-version-support.mdx +++ b/docs/source/routing/federation-version-support.mdx @@ -14,7 +14,7 @@ Update your router regularly to the latest stable version to ensure that it full -## Support table +## Checking compatibility between Apollo Router Core and Apollo Federation versions To ensure your router's federation version is supported, check the [Apollo Federation Changelog](graphos/schema-design/federated-schemas/reference/versions). Make sure that your router's federation version is _at least_ as recent as the version used to compose your supergraph schema. From b86637fd25d06cd804573159776ffccc3989ca65 Mon Sep 17 00:00:00 2001 From: Michelle Mabuyo Date: Mon, 1 Dec 2025 14:02:28 -0500 Subject: [PATCH 3/5] fix link, simplify heading --- docs/source/routing/federation-version-support.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/source/routing/federation-version-support.mdx b/docs/source/routing/federation-version-support.mdx index 9e46b96527..d2a118b2c4 100644 --- a/docs/source/routing/federation-version-support.mdx +++ b/docs/source/routing/federation-version-support.mdx @@ -14,9 +14,9 @@ Update your router regularly to the latest stable version to ensure that it full -## Checking compatibility between Apollo Router Core and Apollo Federation versions +## Checking version compatibility -To ensure your router's federation version is supported, check the [Apollo Federation Changelog](graphos/schema-design/federated-schemas/reference/versions). Make sure that your router's federation version is _at least_ as recent as the version used to compose your supergraph schema. +To ensure your router's federation version is supported, check the [Apollo Federation Changelog](/graphos/schema-design/federated-schemas/reference/versions). Make sure that your router's federation version is _at least_ as recent as the version used to compose your supergraph schema. ## Federation 1 support From 2744f6eb3e64590ea4bff77217009413c1eef7eb Mon Sep 17 00:00:00 2001 From: Joseph Caudle Date: Wed, 3 Dec 2025 18:49:12 -0500 Subject: [PATCH 4/5] Remove reference to federation-version-support Because the Federation Version Support document for Router no longer has a table of supported versions, that document no longer needs to be manually updated when preparing a release of Router. --- RELEASE_CHECKLIST.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/RELEASE_CHECKLIST.md b/RELEASE_CHECKLIST.md index e8730f4952..a88ca99382 100644 --- a/RELEASE_CHECKLIST.md +++ b/RELEASE_CHECKLIST.md @@ -241,8 +241,6 @@ Start following the steps below to start a release PR. The process is **not ful - Run our compliance checks and update the `licenses.html` file as appropriate. - Ensure we're not using any incompatible licenses in the release. -7. **MANUALLY CHECK AND UPDATE** the `federation-version-support.mdx` to make sure it shows the version of Federation which is supported by the Routter. - 11. Now, review and stage he changes produced by the previous step. This is most safely done using the `--patch` (or `-p`) flag to `git add` (`-u` ignores untracked files). ``` From 92c7b1ac5d5ed43f8169d93044b2a0e3ed12ca1d Mon Sep 17 00:00:00 2001 From: Joseph Caudle Date: Wed, 3 Dec 2025 18:50:41 -0500 Subject: [PATCH 5/5] Change references to federation-version-support Instead of directing readers to a document which will redirect them somewhere else (as the version table has been removed), these instructions now point readers directly to the Apollo Federation Changelog. --- apollo-federation/README.md | 2 +- apollo-federation/src/lib.rs | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/apollo-federation/README.md b/apollo-federation/README.md index 24f3e71314..29c5390473 100644 --- a/apollo-federation/README.md +++ b/apollo-federation/README.md @@ -25,7 +25,7 @@ Any version may have breaking API changes, as this API is expected to only be u Instead, the version number matches exactly that of the `apollo-router` crate version using it. This version number is **not** that of the Apollo Federation specification being implemented. -See [Router documentation](https://www.apollographql.com/docs/router/federation-version-support/) +See the [Apollo Federation Changelog](https://www.apollographql.com/docs/graphos/schema-design/federated-schemas/reference/versions) for which Federation versions are supported by which Router versions. ## Contributing diff --git a/apollo-federation/src/lib.rs b/apollo-federation/src/lib.rs index 6eaf722026..253c94a350 100644 --- a/apollo-federation/src/lib.rs +++ b/apollo-federation/src/lib.rs @@ -10,7 +10,7 @@ //! Instead, the version number matches exactly that of the `apollo-router` crate version using it. //! //! This version number is **not** that of the Apollo Federation specification being implemented. -//! See [Router documentation](https://www.apollographql.com/docs/router/federation-version-support/) +//! See the [Apollo Federation Changelog](https://www.apollographql.com/docs/graphos/schema-design/federated-schemas/reference/versions) //! for which Federation versions are supported by which Router versions. #![warn(