Skip to content

Replace redirecting links with their targets - #1150

Merged
ideaship merged 1 commit into
mainfrom
docs-fix-redirecting-links
Nov 19, 2026
Merged

ideaship merged 1 commit into
mainfrom
docs-fix-redirecting-links

Conversation

@jklare

@jklare jklare commented Nov 19, 2026

Copy link
Copy Markdown
Contributor

lychee reports links that only work through a redirect. This PR points them straight at the page they redirect to:

  • docs.ansible.com moved its docs from /ansible/latest/ to /projects/ansible/latest/ (testbed prerequisites, Ceph deploy guide, OSISM 7 release notes).
  • GitHub moved its pull request and workflow syntax docs (developer guide, comment in deploy.yml).
  • Red Hat moved its LimitRequestBody article to /kb/ and serves CVE pages under lowercase IDs (Horizon configuration guide).
  • Launchpad: launchpad.net/bugs/N redirects to bugs.launchpad.net/glance/+bug/N (OSSA-2026-038).
  • rfc-editor.org: /rfc/rfc2119 redirects to /info/rfc2119/ (Redfish appendix).
  • osism.tech: /docs and the loadbalancer page need a trailing slash (navbar logo link, OSISM 7 release notes).

It also fixes a typo in OSSA-2026-038: one link's text said bug #2160330, but the link pointed to 2161330. Bug 2160330 doesn't exist, and the OSSA lists 2161330, so the text now says #2161330.

The github.com/osism/issues/issues/new links still redirect. They are correct, but GitHub sends visitors who aren't logged in to the login page, so they stay unchanged.

Testing

I ran the tools from the MegaLinter documentation v10 image on the changed files:

  • lychee finds 0 errors, and the only redirects left are the two GitHub links.
  • markdownlint, markdown-table-formatter and prettier all pass.
  • All new URLs return 200, and the anchors in the Ansible, GitHub and loadbalancer links exist on the new pages.

🤖 Generated with Claude Code

lychee reports links that only work through a redirect. Point them
straight at the page they redirect to:

- docs.ansible.com moved its docs from /ansible/latest/ to
  /projects/ansible/latest/ (testbed prerequisites, Ceph deploy
  guide, OSISM 7 release notes).
- GitHub moved its pull request and workflow syntax docs (developer
  guide, comment in the deploy workflow).
- Red Hat moved its LimitRequestBody article to /kb/ and serves CVE
  pages under lowercase IDs (Horizon configuration guide).
- launchpad.net/bugs/N redirects to bugs.launchpad.net/glance/+bug/N
  (OSSA-2026-038).
- rfc-editor.org/rfc/rfc2119 redirects to /info/rfc2119/ (Redfish
  appendix).
- osism.tech/docs and the loadbalancer page need a trailing slash
  (navbar logo link, OSISM 7 release notes).

All new URLs return 200, and the anchors in the Ansible, GitHub and
loadbalancer links exist on the new pages.

OSSA-2026-038 also had a typo in one bug link: the link text said
#2160330, but the link pointed to 2161330. Bug 2160330 does not exist,
and the OSSA lists 2161330, so correct the link text.

The github.com/osism/issues/issues/new links still redirect. They are
correct, but GitHub sends visitors who are not logged in to the login
page, so they stay unchanged.

Assisted-by: Claude:claude-opus-5-5
Signed-off-by: Jan Klare <klare@osism.tech>
@github-actions

Copy link
Copy Markdown

✅⚠️MegaLinter analysis: Success with warnings

Descriptor Linter Files Fixed Errors Max errors Warnings Elapsed time
✅ ACTION actionlint 5 0 0 0.05s
✅ JSON jsonlint 4 0 0 0.08s
✅ JSON prettier 4 0 0 0.29s
✅ JSON v8r 4 0 0 8.71s
✅ MARKDOWN markdownlint 184 0 0 2.34s
✅ MARKDOWN markdown-table-formatter 184 0 0 0.22s
✅ REPOSITORY betterleaks yes no no 0.59s
✅ REPOSITORY checkov yes no no 15.41s
✅ REPOSITORY git_diff yes no no 0.04s
✅ REPOSITORY secretlint yes no no 1.06s
✅ REPOSITORY trufflehog yes no no 2.28s
✅ SPELL codespell 194 0 0 0.51s
⚠️ SPELL lychee 194 5 0 15.13s
✅ YAML prettier 6 0 0 0.28s
✅ YAML v8r 6 0 0 5.65s
✅ YAML yamllint 6 0 0 0.38s

Detailed Issues

⚠️ SPELL / lychee - 5 errors
📝 Summary
---------------------
🔍 Total.........1312
🔗 Unique.........963
✅ Successful....1184
⏳ Timeouts.........3
🔀 Redirected.......1
👻 Excluded.......120
❓ Unknown..........0
🚫 Errors...........5
⛔ Unsupported......5

Errors in .claude/skills/security-advisory/reference/style.md
[ERROR] file://.claude/skills/guides/operations-guide/openstack/security-updates.md (at 189:3) | File not found. Check if file exists and path is correct

Errors in .claude/skills/security-advisory/SKILL.md
[400] https://cveawg.mitre.org/api/cve/ (at 16:18) | Rejected status code: 400 Bad Request
[404] https://raw.githubusercontent.com/osism/ (at 17:18) | Rejected status code: 404 Not Found
[400] https://registry.osism.tech/service/token (at 18:19) | Rejected status code: 400 Bad Request

Errors in docs/concepts/cluster-network.md
[TIMEOUT] https://stordis.com/basic-configuration-and-management-of-sonic-devices/ (at 196:3) | Request timed out
[TIMEOUT] https://stordis.com/bgp-unnumbered-in-enterprise-sonic/ (at 66:1) | Request timed out
[TIMEOUT] https://stordis.com/deploying-bgp-underlay-in-enterprise-sonic/ (at 197:3) | Request timed out

Errors in docs/guides/developer-guide/style-guide.md
[ERROR] https://wiki.openstack.org/wiki/GitCommitMessages (at 79:1) | Network unreachable. Check internet connection or VPN settings

Hint: Followed 1 redirect. You might want to consider replacing redirecting URLs with the resolved URLs. Use verbose mode (`-v`/`-vv`) to see redirection details.

See detailed reports in MegaLinter artifacts

Your project could benefit from a custom flavor, which would allow you to run only the linters you need, and thus improve runtime performances. (Skip this info by defining FLAVOR_SUGGESTIONS: false)

  • Documentation: Custom Flavors
  • Command: npx mega-linter-runner@10.2.0 --custom-flavor-setup --custom-flavor-linters ACTION_ACTIONLINT,JSON_JSONLINT,JSON_V8R,JSON_PRETTIER,MARKDOWN_MARKDOWNLINT,MARKDOWN_MARKDOWN_TABLE_FORMATTER,REPOSITORY_CHECKOV,REPOSITORY_GIT_DIFF,REPOSITORY_BETTERLEAKS,REPOSITORY_SECRETLINT,REPOSITORY_TRUFFLEHOG,SPELL_LYCHEE,SPELL_CODESPELL,YAML_PRETTIER,YAML_YAMLLINT,YAML_V8R

MegaLinter is provided by OX Security
Show us your support by starring ⭐ the repository

@ideaship
ideaship merged commit c20a69b into main Nov 19, 2026
6 checks passed
@ideaship
ideaship deleted the docs-fix-redirecting-links branch November 19, 2026 10:03
@github-project-automation github-project-automation Bot moved this from New to Done in Human Board Nov 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants