Skip to content

fix(docs): repair 9 broken external URLs across controls and playbooks#333

Merged
judeper merged 1 commit into
mainfrom
ocean/issue-38
May 25, 2026
Merged

fix(docs): repair 9 broken external URLs across controls and playbooks#333
judeper merged 1 commit into
mainfrom
ocean/issue-38

Conversation

@judeper
Copy link
Copy Markdown
Owner

@judeper judeper commented May 25, 2026

Comprehensive Documentation & URL Review — Issue #38

Summary

Full scan of 625 markdown docs and 78 control files in FSI-AgentGov. Checked 972 external URLs (704 Microsoft Learn + 268 others) and all internal link references.

Findings

URLs checked:

  • ✅ 704 Microsoft Learn URLs — all valid, none stale
  • ✅ 259 non-Microsoft URLs — valid
  • ❌ 9 broken external URLs — fixed in this PR

Broken URLs fixed:

File Issue Fix
deny-event-correlation-report/index.md 3 refs to renamed docs (SCHEMA.md, FLOW_SETUP.md, EVIDENCE_EXPORT.md) Updated to current filenames (architecture.md, README.md)
3.8 Copilot Hub & Governance Dashboard agent-access-monitor/src → 404 Changed to /scripts
3.11 Centralized Agent Inventory agent-inventory-enforcement-monitor → 404 Changed to agent-registry-automation
2.22 troubleshooting playbook SOLUTION-DOCUMENTATION.md → 404 Changed to README.md
1.8 verification-testing playbook NY DFS cyber_faqs → 404 Changed to cybersecurity
1.23 Step-up Authentication CSRC old search URL → redirect to generic page Updated to new CPRT catalog URL with element anchor
2.8 Access Control & SoD CSRC old search URL → redirect to generic page Updated to new CPRT catalog URL with element anchor

Other validations — all passing:

  • mkdocs build --strict — zero errors/warnings
  • verify_controls.py — all 78 controls have required 10-section structure
  • verify_language_rules.py — no prohibited FSI language found
  • ✅ All control footers at v1.6.2
  • ✅ No stale docs.microsoft.com references (all already learn.microsoft.com)
  • ✅ Regulatory references (OCC, FINRA, SEC, NIST) current and correctly cited

What was NOT changed

  • No content rewrites (only URL fixes)
  • No structural changes to controls
  • No navigation changes

Closes judeper/OceanSquad#38

- Fix 3 FSI-AgentGov-Solutions links in deny-event-correlation-report
  (SCHEMA.md -> architecture.md, FLOW_SETUP.md/EVIDENCE_EXPORT.md -> README.md)
- Fix agent-access-monitor/src -> agent-access-monitor/scripts (3.8)
- Fix agent-inventory-enforcement-monitor -> agent-registry-automation (3.11)
- Fix inactivity-timeout-enforcement/SOLUTION-DOCUMENTATION.md -> README.md (2.22)
- Fix NY DFS cyber_faqs -> cybersecurity URL (1.8)
- Update 2 CSRC SP 800-53 control search URLs to new CPRT catalog (1.23, 2.8)

Validated: mkdocs build --strict, verify_controls.py, verify_language_rules.py
All 704 Microsoft Learn URLs verified live (0 broken).
All 268 non-Microsoft URLs checked (9 broken, now fixed).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@judeper judeper merged commit 077f4bd into main May 25, 2026
18 of 19 checks passed
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.

1 participant