Skip to content

docs-bug: v21 documentation is unreachable #33804

Closed

Description

@mwaibel-go

Documentation Feedback

Selecting v21 in the version dropdown on https://material.angular.dev/cdk/categories leads to https://v21.material.angular.dev/cdk/categories. All the links there lead to https://angular.dev/guide/$component, which defaults to v22. Reverting to v21 there leads to the overview page because the documentation for CDK components didn’t exist before v22. This makes old CDK documentation inaccessible.

Whenever there’s an update to how the documentation is laid out, there are lots of dead links. I wish you’d pay more attention to how links to and from old versions behave when you make these changes.

Affected documentation page

https://v21.material.angular.dev/cdk/categories

Activity

  1. added
    docsThis issue is related to documentation
    needs triageThis issue needs to be triaged by the team
    on Sep 14, 2026
  2. self-assigned this
    on Sep 15, 2026
  3. added
    P3An issue that is relevant to core functions, but does not impede progress. Important, but not urgent
    and removed
    needs triageThis issue needs to be triaged by the team
    on Sep 15, 2026
  4. added a commit that references this issue on Sep 15, 2026
    76c229e
  5. added a commit that references this issue on Sep 15, 2026
    28e10ef
  6. added a commit that references this issue on Sep 15, 2026
    e25db3e
  7. mwaibel-go commented on Sep 16, 2026

    @mwaibel-go
    Author

    The error still persists for the Drag and Drop feature.
    https://v21.material.angular.dev/cdk/categories links to https://angular.dev/guide/drag-drop (where v22 is selected). Selecting v21 there leads to https://v21.angular.dev/overview.

    (Otherwise thanks for the quick fix)

  8. crisbeto commented on Sep 16, 2026

    @crisbeto
    Member

    Ah yeah, I think I need to backport it to the other branches.

  9. added 2 commits that reference this issue on Sep 18, 2026
    218a6c7
    d63c34b
  10. crisbeto commented on Sep 25, 2026

    @crisbeto
    Member

    I cherry picked the fix, but I think we stopped deploying the v21 docs at some point.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

P3An issue that is relevant to core functions, but does not impede progress. Important, but not urgentarea: material.angular.iodocsThis issue is related to documentationgemini-triagedLabel noting that an issue has been triaged by gemini

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions