Skip to content

docs: remove the Sphinx anchor aliases from the user guide build - #10775

Merged
paulbalandan merged 1 commit into
codeigniter4:developfrom
paulbalandan:docs-drop-anchors
Nov 15, 2026
Merged

paulbalandan merged 1 commit into
codeigniter4:developfrom
paulbalandan:docs-drop-anchors

Conversation

@paulbalandan

Copy link
Copy Markdown
Member

Description
Removes docs/.anchors.json and admin/anchors.py. The map held the old Sphinx heading ids for each page, and the script added them as <a id> aliases to the built HTML.

The Markdown guide is now the only source, so the old Sphinx ids are no longer worth maintaining. A link to an old #anchor still opens the right page, at the top. Page URLs are not affected.

The python admin/anchors.py step is removed from test-userguide.yml, deploy-userguide-latest.yml and .github/scripts/deploy-userguide, together with the admin/anchors.py path triggers. The manual process in admin/RELEASE.md loses the same step.

Checklist:

  • Securely signed commits
  • Component(s) with PHPDoc blocks, only if necessary or adds value (without duplication)
  • Unit testing, with >80% coverage
  • User guide updated
  • Conforms to style guide

@paulbalandan
paulbalandan merged commit 55ca87b into codeigniter4:develop Nov 15, 2026
8 checks passed
@paulbalandan
paulbalandan deleted the docs-drop-anchors branch November 15, 2026 12:45
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.

3 participants