Skip to content

docs: use direct same-page xref for Ignored Files Editor#742

Merged
phil-davis merged 1 commit into
masterfrom
fix/727-ignored-files-xref
Jun 22, 2026
Merged

docs: use direct same-page xref for Ignored Files Editor#742
phil-davis merged 1 commit into
masterfrom
fix/727-ignored-files-xref

Conversation

@DeepDiver1975

Copy link
Copy Markdown
Member

What

Replaces the alias-routed xref at using.adoc:630 with a direct same-page xref: navigating.adoc#using-the-ignored-files-editorusing-the-ignored-files-editor.

Why

navigating.adoc is only a page-aliases entry of using.adoc itself, so this was a same-page link routed through the page's own alias — brittle and inconsistent. The target heading ==== Using the Ignored Files Editor (using.adoc:570) exists. This matches the existing correct same-page xref at using.adoc:538.

Closes #727

Companion PR onto the 7.1 branch: same change applied there.

🤖 Generated with Claude Code

@DeepDiver1975 DeepDiver1975 left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

🤖 Automated code review by Claude Code review agent

Approve. Replaces the alias-routed xref with a direct same-page xref: xref:navigating.adoc#using-the-ignored-files-editor[...]xref:using-the-ignored-files-editor[...].

  • Verified the new target resolves: the heading ==== Using the Ignored Files Editor exists in using.adoc (generated id using-the-ignored-files-editor).
  • Confirmed navigating.adoc is only a page-aliases entry of using.adoc itself (:page-aliases: navigating.adoc), so the old form was a brittle self-alias route. The new form matches the already-correct same-page xref elsewhere in the file (xref:using-the-ignored-files-editor[see below]).
  • AsciiDoc syntax correct.

Pair consistency: identical diff to 7.1 companion #741, correct master base, Closes #727 carried here. LGTM.

The xref routed through `navigating.adoc#using-the-ignored-files-editor`,
but `navigating.adoc` is only a page-aliases entry of using.adoc itself.
This is a brittle self-referential link through the page's own alias.
Replace it with a direct same-page xref, matching the existing correct
reference elsewhere on the page (using.adoc:538).

Closes #727

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Thomas Müller <1005065+DeepDiver1975@users.noreply.github.com>
@phil-davis phil-davis force-pushed the fix/727-ignored-files-xref branch from b236910 to debb759 Compare June 22, 2026 09:18
@phil-davis phil-davis merged commit 3344fb7 into master Jun 22, 2026
2 checks passed
@phil-davis phil-davis deleted the fix/727-ignored-files-xref branch June 22, 2026 09:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: fragile self-referential xref via navigating.adoc alias in using.adoc

2 participants