Skip to content

docs: fix broken RFC links in reference docs (P1-5)#37

Merged
beonde merged 1 commit into
mainfrom
fix/docs-p1-mcp-dedup-links
May 2, 2026
Merged

docs: fix broken RFC links in reference docs (P1-5)#37
beonde merged 1 commit into
mainfrom
fix/docs-p1-mcp-dedup-links

Conversation

@beonde
Copy link
Copy Markdown
Member

@beonde beonde commented May 2, 2026

Summary

Fix broken RFC links that use incorrect file names and malformed URLs.

Documentation Audit Reference

Phase: P1-5
Severity: High

Changes

  • docs/reference/grpc.md: Fix 3 RFC links (RFC-002, RFC-006, RFC-007)
  • docs/reference/server/index.md: Fix RFC-002 link URL base
  • docs/reference/server/badge-ca.md: Fix RFC-002 and RFC-003 link URL base
  • docs/reference/sdk-python/mcp.md: Fix RFC-006 and RFC-007 file names

Fixes Applied

  • RFC-006: 006-mcp-tool-authority.md006-mcp-tool-authority-evidence.md
  • RFC-007: 007-mcp-server-identity.md007-mcp-server-identity-discovery.md
  • URL base: docs.capisc.io/rfcs/blob/main/docs/github.com/capiscio/capiscio-rfcs/blob/main/docs/

Verification

  • File names verified against capiscio-rfcs/docs/ directory listing
  • All links now point to valid GitHub blob URLs

- Fix RFC-006 filename: 006-mcp-tool-authority.md → 006-mcp-tool-authority-evidence.md
- Fix RFC-007 filename: 007-mcp-server-identity.md → 007-mcp-server-identity-discovery.md
- Fix URL base: docs.capisc.io/rfcs/blob/... → github.com/capiscio/capiscio-rfcs/blob/...

Files fixed: grpc.md, server/index.md, server/badge-ca.md, sdk-python/mcp.md

Ref: DOCS_REMEDIATION_PLAN P1-5
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 2, 2026

✅ Documentation Build Successful

The documentation build completed successfully and passed validation checks.

  • ✅ Build completed without errors
  • ✅ Critical files present (index.html, sitemap.xml, robots.txt)
  • ✅ Link validation completed

This PR will deploy to dev-docs.capisc.io when merged to main.

@beonde beonde merged commit 01254ca into main May 2, 2026
4 checks passed
@beonde beonde deleted the fix/docs-p1-mcp-dedup-links branch May 2, 2026 18:13
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