docs: persist custom domain via docs/CNAME (fix cmcp.agentrust-io.com 404)#394
Merged
Conversation
mkdocs gh-deploy only ships files under docs/. The custom domain cmcp.agentrust-io.com lived only in the repo-root CNAME, which mkdocs ignores, so gh-deploy --clean dropped it and GitHub Pages 404d on the subdomain (cmcp was the only project missing it vs ca2a/manifest/trace). Putting CNAME in docs/ makes every deploy preserve the domain. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The custom domain now lives in docs/CNAME, which mkdocs publishes on every gh-deploy. The repo-root CNAME is not used by the mkdocs build (Pages source is the gh-pages branch), so it is safe to remove. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
docs/CNAMEcontainingcmcp.agentrust-io.com.CNAME.Why
cmcp.agentrust-io.comwas returning GitHub Pages 404 ("There isn't a GitHub Pages site here"). cmcp was the only project missing its Pages custom domain; ca2a / manifest / trace all have theirs set.Root cause:
mkdocs gh-deploy --force --clean(in.github/workflows/docs.yml) publishes only files underdocs/. The custom domain value lived solely in the repo-rootCNAME, which mkdocs does not copy, so a clean deploy dropped the CNAME fromgh-pagesand GitHub unset the custom domain.Fix
cmcp.agentrust-io.comvia the Pages API. Site is live again (HTTP 200, HTTPS cert approved).CNAMEinsidedocs/so everymkdocs gh-deployrepublishes it and the domain cannot be wiped again, matching the sibling docs sites. The repo-rootCNAMEis removed since the Pages source is thegh-pagesbranch and mkdocs never used it.🤖 Generated with Claude Code