Skip to content

Conversation

@abishekgiri
Copy link

What does this PR do?

This PR fixes documentation pages that generate duplicate anchor IDs,
which can cause links to options or sections to resolve incorrectly.

The issue occurs when multiple headings or options produce the same
auto-generated anchor.


What’s included?

  • Updated affected documentation to ensure anchor IDs are unique
  • Adjusted headings or anchor definitions where necessary
  • No changes to documented behavior or content semantics

Why is this useful?

Duplicate anchor IDs can break deep links and make it difficult to
reference specific options or sections in the documentation.

This change ensures links are stable and behave as expected.


Verification

  • Manually verified that affected pages no longer contain duplicate anchors
  • Confirmed links resolve to the intended sections

Fixes #14822

@github-actions github-actions bot added team-Documentation Documentation improvements that cannot be directly linked to other team labels awaiting-review PR is awaiting review from an assigned reviewer labels Jan 26, 2026
Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request resolves duplicate anchor IDs in several documentation files (design-documents.md, bazel-and-java.md, and cquery.md). The changes modify the conflicting anchor IDs to be more specific, which correctly fixes linking issues caused by the duplicates. The changes are straightforward, effective, and look good.

@iancha1992 iancha1992 added the team-OSS Issues for the Bazel OSS team: installation, release processBazel packaging, website label Jan 27, 2026
@fweikert fweikert added awaiting-PR-merge PR has been approved by a reviewer and is ready to be merge internally and removed awaiting-review PR is awaiting review from an assigned reviewer labels Jan 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting-PR-merge PR has been approved by a reviewer and is ready to be merge internally team-Documentation Documentation improvements that cannot be directly linked to other team labels team-OSS Issues for the Bazel OSS team: installation, release processBazel packaging, website

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Documentation issue: multiple anchors to the same option doesn't work

3 participants