Update documentation for v2.17 (#5071)

* Update current version

* Update doc indexes

* Update roadmap

* Add breaking changes

* Update docs/hugo/content/guide/breaking-changes/breaking-changes-v2.17.0.md

Co-authored-by: Jack Jiang <[email protected]>

---------

Co-authored-by: Jack Jiang <[email protected]>

Author: theunrepentantgeek

ROADMAP.md

@@ -10,11 +10,11 @@ Our current release plan:
 
 | Version                                                                |   Estimated Release |
 | ---------------------------------------------------------------------- | ------------------: |
-| [2.16.0](https://github.com/Azure/azure-service-operator/milestone/35) |    Mid October 2025 |
-| [2.17.0](https://github.com/Azure/azure-service-operator/milestone/36) | Early December 2025 |
 | [2.18.0](https://github.com/Azure/azure-service-operator/milestone/37) | Early February 2026 |
-| 2.19.0                                                                 |      Mid April 2026 |
-| 2.20.0                                                                 |       Mid June 2026 |
+| [2.19.0](https://github.com/Azure/azure-service-operator/milestone/38) |      Mid April 2026 |
+| [2.20.0](https://github.com/Azure/azure-service-operator/milestone/39) |       Mid June 2026 |
+| 2.21.0                                                                 |     Mid August 2026 |
+| 2.22.0                                                                 |    Mid October 2026 |
 
 Where linked, versions go to a list of feature and bugs that are planned to be included in that release.
 
@@ -32,6 +32,8 @@ Official releases of ASO v2:
 
 | Version                                                                        |     Release Date |                                                                                        |
 | ------------------------------------------------------------------------------ | ---------------: | -------------------------------------------------------------------------------------- |
+| [2.17.0](https://github.com/Azure/azure-service-operator/milestone/36)         |  8 December 2025 | Release cycle was abbreviated to get key items out before the 2025/2026 holiday season |
+| [2.16.0](https://github.com/Azure/azure-service-operator/milestone/35)         |  22 October 2025 |
 | [2.15.0](https://github.com/Azure/azure-service-operator/releases/tag/v2.15.0) |   20 August 2025 |                                                                                        |
 | [2.14.0](https://github.com/Azure/azure-service-operator/releases/tag/v2.14.0) |     24 June 2025 |                                                                                        |
 | [2.13.0](https://github.com/Azure/azure-service-operator/releases/tag/v2.13.0) |    23 April 2025 |                                                                                        |

docs/hugo/content/guide/breaking-changes/breaking-changes-v2.17.0.md

@@ -0,0 +1,13 @@
+---
+title: "v2.17.0 Breaking Changes"
+linkTitle: "v2.17.0"
+weight: -50  # This should be 5 lower than the previous breaking change document
+---
+## Breaking changes
+
+* Removed containerservice v20230315preview versions of Fleet resources as the API has been deprecated by Azure. If you allow the operator to manage its own CRDs via `--crd-pattern`, no action is needed as the operator will take care of removing these versions. If you manage the CRD versions yourself, you'll need to run [asoctl clean crds](https://azure.github.io/azure-service-operator/tools/asoctl/#clean-crds) before upgrading.
+
+## Upcoming breaking changes
+
+* Will remove containerservice ManagedCluster and AgentPool api version v1api20230201 and v1api20231001 in v2.18 of ASO.
+* Will remove containerservice ManagedCluster and AgentPool api version v1api20240402preview in v2.19 of ASO.

docs/hugo/content/reference/_index.md

@@ -5,17 +5,16 @@ no_list: true
 ---
 To install the CRDs for these resources, your ASO configuration must include `batch.azure.com/*` as one of the configured CRD patterns. See [CRD Management in ASO](https://azure.github.io/azure-service-operator/guide/crd-management/) for details on doing this for both [Helm](https://azure.github.io/azure-service-operator/guide/crd-management/#helm) and [YAML](https://azure.github.io/azure-service-operator/guide/crd-management/#yaml) based installations.
 
-### Next Release
-
-Development of these new resources is complete and they will be available in the next release of ASO.
+### Latest Released Versions
 
+These resource(s) are the latest versions available for use in the current release of ASO. Different versions of a given resource reflect different versions of the Azure ARM API.
 | Resource     | ARM Version | CRD Version | Supported From | Sample                                                                                                                   |
 |--------------|-------------|-------------|----------------|--------------------------------------------------------------------------------------------------------------------------|
 | BatchAccount | 2024-07-01  | v20240701   | v2.17.0        | [View](https://github.com/Azure/azure-service-operator/tree/main/v2/samples/batch/v20240701/v20240701_batchaccount.yaml) |
 
-### Released
+### Other Supported Versions
 
-These resource(s) are available for use in the current release of ASO. Different versions of a given resource reflect different versions of the Azure ARM API.
+These are older versions of resources still available for use in the current release of ASO. Different versions of a given resource reflect different versions of the Azure ARM API.
 | Resource                                                                     | ARM Version | CRD Version   | Supported From | Sample                                                                                                                           |
 |------------------------------------------------------------------------------|-------------|---------------|----------------|----------------------------------------------------------------------------------------------------------------------------------|
 | [BatchAccount]({{< relref "/reference/batch/v1api20210101#BatchAccount" >}}) | 2021-01-01  | v1api20210101 | v2.0.0         | [View](https://github.com/Azure/azure-service-operator/tree/main/v2/samples/batch/v1api20210101/v1api20210101_batchaccount.yaml) |