Skip to content

[link-checker] Fix broken gh-aw reference links in cost-tracker docs - #385

Draft
github-actions[bot] wants to merge 1 commit into
mainfrom
fix-broken-doc-links-20261002-33d42355172fb768
Draft

github-actions[bot] wants to merge 1 commit into
mainfrom
fix-broken-doc-links-20261002-33d42355172fb768

Conversation

@github-actions

@github-actions github-actions Bot commented Oct 2, 2026

Copy link
Copy Markdown
Contributor

Summary

Fixed 2 broken links discovered by the daily link checker. All other "broken" links in the latest scan were false positives — the link checker's regex captured trailing markdown punctuation (e.g. ), )., )**) as part of the URL, so links like https://github.com/githubnext/crane) report 404 even though https://github.com/githubnext/crane (without the trailing )) is a perfectly valid, working URL. These are not real issues and require no fix.

Links fixed

File Old (broken) New (working)
docs/cost-tracker.md https://github.github.com/gh-aw/reference/token-usage/ `(github.github.io/redacted)
docs/cost-tracker.md https://github.github.com/gh-aw/reference/firewall/ `(github.github.io/redacted)
workflows/cost-tracker.md https://github.github.com/gh-aw/reference/token-usage/ `(github.github.io/redacted)

Root cause: the links used the wrong domain (github.github.com instead of the real gh-aw docs domain github.github.io) and pointed at nonexistent paths (reference/token-usage/, reference/firewall/). I verified via the github GitHub repo (github/gh-aw) docs source that:

  • token-usage.jsonl is documented under the Artifacts reference page, specifically the firewall-audit-logs section.
  • Firewall/network configuration is documented under the Network reference page.

Both new URLs were confirmed to resolve successfully.

Unfixable links (cache memory)

  • https://github.com/owner/repo/vex/GHSA-xvch-5gv4-984h in docs/vex-generator.md — intentional placeholder/example URL, not a real link. Remains in the unfixable list (unchanged from prior runs).

The two github.github.com/gh-aw/reference/{token-usage,firewall}/ entries were removed from the unfixable list since they are now fixed.

Verification

Cross-checked all 53 "❌ broken" entries from link-check-results.md against the 72 "✅ working" entries by stripping trailing markdown punctuation — only 3 genuinely lacked a working counterpart, and 2 of those are the links fixed here.

Generated by Daily Link Checker & Fixer · copilot · auto · 74.2 AIC · ⌖ 17.7 AIC · ⊞ 9K · ◷

The links used the wrong domain (github.github.com instead of
github.github.io) and pointed to nonexistent paths
(reference/token-usage/, reference/firewall/). Replaced with the
correct, working URLs:
- https://github.github.io/gh-aw/reference/artifacts/#firewall-audit-logs
- https://github.github.io/gh-aw/reference/network/

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions github-actions Bot added automated documentation Improvements or additions to documentation labels Oct 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automated documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant