Skip to content

docs: clarify a custom domain belongs to one docs project - #6503

Closed
devin-ai-integration[bot] wants to merge 1 commit into
mainfrom
devin/1785769761-custom-domain-uniqueness
Closed

docs: clarify a custom domain belongs to one docs project#6503
devin-ai-integration[bot] wants to merge 1 commit into
mainfrom
devin/1785769761-custom-domain-uniqueness

Conversation

@devin-ai-integration

Copy link
Copy Markdown
Contributor

Summary

Documents custom-domain ownership semantics, which weren't stated anywhere: a custom domain serves whichever docs deployment published most recently with that domain declared, and uniqueness is only enforced across organizations. Two repos in the same org can both declare one domain and silently overwrite each other on publish.

  • setting-up-your-domain.mdx: new ### One domain per docs project section (with the multi-source exception called out) plus a <Warning> covering the same-org collision and the fix (remove the domain from all but the owning repo, republish).
  • site-level-settings.mdx: one-sentence pointer from the instances.custom-domain ParamField to that anchor.

Vale hook passes; fern check --warnings reports 0 errors.

Link to Devin session: https://app.devin.ai/sessions/b9be75edfa5044d4868aabbc3b93ca4c

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration
devin-ai-integration Bot requested a review from devalog as a code owner August 3, 2026 15:09
@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

@github-actions

github-actions Bot commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

@devalog devalog closed this Aug 3, 2026
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