[DOCS] Broken Internal links / anchors in localized documentation (non-English versions)

Documentation Type

Broken links

Documentation Location

In localized versions of the Claude Code docs (e.g., Italian), internal links point to anchors

Section/Topic

Internal links / anchors in localized documentation (non-English versions)

Current Documentation

In localized versions of the Claude Code docs (e.g., Italian), internal links point to anchors such as:
https://code.claude.com/docs/it/memory#organize-rules-with-clauderules

However, the actual section in the localized page uses a different anchor (translated slug), for example:
https://code.claude.com/docs/it/memory#organizza-le-regole-con-claude/rules/

What's Wrong or Missing?

Internal links are not aligned with the localized section IDs. They appear to reuse English anchor names, while localized pages generate translated anchors. As a result, clicking these links does not navigate to the correct section because the target anchor does not exist in the page.

This issue is not limited to Italian and likely affects all non-English localized versions of the documentation.

Suggested Improvement

Ensure that internal links in localized documentation point to the correct localized anchor IDs.

Possible fixes:

Generate consistent anchor IDs across all languages (e.g., keep English slugs everywhere), or
Update internal links dynamically to match the localized slugs for each language

Additionally, a validation step during build/deploy could detect broken anchor links in localized pages.

Impact

Low - Minor confusion or inconvenience

Additional Context

<img width="881" height="526" alt="Image" src="https://github.com/user-attachments/assets/474e1ff9-a87a-48e5-bad5-a9900eaec5d1" />

<img width="925" height="652" alt="Image" src="https://github.com/user-attachments/assets/b7213ada-5908-4f54-a0b0-493f16ecb025" />