fix(docs): repoint canonical to authsome.ai and drop dead links#271
Merged
Merged
Conversation
Mintlify generates the sitemap from seo.metatags.canonical, and the canonical was still pointing at authsome.agentr.dev. Every <loc> in https://authsome.ai/docs/sitemap.xml carried the old domain even though the docs are now hosted at authsome.ai. Domain rename: - docs.json canonical to https://authsome.ai/docs. - docs.json footer "Home" link to https://authsome.ai. - custom-providers.mdx schema URL to authsome.ai. Security disclosure: - Drop the security@agentr.dev email path from disclosure.mdx and route all reports through GitHub's private security advisory flow. The email was the only contact path that needed mailbox maintenance; GitHub advisories give us the same private channel without it. Dead links (target files deleted upstream in 019bdd1 and ec06181): - roadmap.mdx: drop both references to docs/authsome-design.md (moved to docs/internal/, not public-facing). - daemon-trust-boundary.mdx: replace authsome-design.md reference with a link to the public /roadmap page. - encryption.mdx: drop docs/specs/authsome-v1.md reference; keep the prose describing the future portable spec. - credential-storage.mdx: same fix as encryption.mdx, also drops one stale manojbajaj95 owner reference incidentally.
3 tasks
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
2 participants
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.
Summary
The Mintlify-generated sitemap at
https://authsome.ai/docs/sitemap.xmlstill had every<loc>pointing at the oldauthsome.agentr.devdomain becauseseo.metatags.canonicalindocs.jsonwas stale. This fixes the sitemap, plus drops several broken internal links that surfaced in a follow-up link audit.Changes
Domain rename (canonical + footer):
docs/site/docs.jsoncanonical tohttps://authsome.ai/docs.docs/site/docs.jsonfooter "Home" link tohttps://authsome.ai.docs/site/guides/custom-providers.mdxschema URL toauthsome.ai.Security disclosure flow:
security@agentr.devemail path fromdisclosure.mdx. All reports now route through GitHub's private security advisory flow. This requires Private Vulnerability Reporting to be enabled in repo Settings under Security to make/security/advisories/newresolve for non-maintainers.Dead links (4 references in 4 files):
roadmap.mdx: drop both references todocs/authsome-design.md(moved todocs/internal/upstream, not public-facing).daemon-trust-boundary.mdx: replace theauthsome-design.mdlink with a link to the public/roadmappage.encryption.mdx: drop thedocs/specs/authsome-v1.mdreference (file deleted upstream); keep the prose describing the future portable spec.credential-storage.mdx: same fix asencryption.mdx. Incidentally removes one stalemanojbajaj95owner reference too.Out of scope (follow-up PR)
A broader link audit also found ~10 active
manojbajaj95/authsomereferences inCONTRIBUTING.md,skills/authsome/SKILL.md, and a few other docs that should be updated toagentrhq/authsome.SKILL.mdis the most active one since it includes agh issue create --repo manojbajaj95/authsomecommand that misroutes user issue submissions. Will open as a separate PR.CHANGELOG.mdalso has ~100manojbajaj95URLs but is auto-regenerated by release-please on every release, so a manual fix would be overwritten. Leaving alone.Five external provider dashboard URLs (beehiiv, calendly, keywordseverywhere, mention-me, savvycal) returned 404 because the providers reorganized their settings pages. Out of repo scope.
Test plan
https://authsome.ai/docs/sitemap.xmland confirm every<loc>now usesauthsome.ai.agentrhq/authsomeat https://github.com/agentrhq/authsome/settings/security_analysis so the/security/advisories/newlink indisclosure.mdxresolves.roadmap,daemon-trust-boundary,encryption,credential-storage) and confirm no broken links remain.