Skip to content

fix(docs): make docs.asdecided.com canonical - #12

Merged
tcballard merged 3 commits into
mainfrom
agent/docs-canonical-host
Aug 3, 2026
Merged

fix(docs): make docs.asdecided.com canonical#12
tcballard merged 3 commits into
mainfrom
agent/docs-canonical-host

Conversation

@tcballard

Copy link
Copy Markdown
Contributor

What changed

  • Set MkDocs site_url to https://docs.asdecided.com/ so generated canonical tags and sitemap URLs use the branded documentation host.
  • Add a root robots.txt with the docs sitemap directive and explicit AI/search crawler access.
  • Add a docs-specific llms.txt that identifies docs.asdecided.com as canonical and links to the authoritative documentation and source repositories.

Why

The docs host previously declared asdecided.github.io as canonical while GitHub Pages redirected that host back to docs.asdecided.com, creating conflicting canonical and sitemap signals.

Validation

  • mkdocs build --strict passes locally after vendoring Core and specification sources.
  • Generated sitemap uses https://docs.asdecided.com/ URLs.
  • Generated canonical tags use https://docs.asdecided.com/.
  • Generated robots.txt and llms.txt are present at the site root.

@tcballard
tcballard marked this pull request as ready for review August 3, 2026 16:38
@tcballard
tcballard merged commit 108ec7e into main Aug 3, 2026
2 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