Skip to content

docs: add multi-source docs page#5269

Open
devin-ai-integration[bot] wants to merge 5 commits intomainfrom
devin/1777565083-add-multi-source-docs
Open

docs: add multi-source docs page#5269
devin-ai-integration[bot] wants to merge 5 commits intomainfrom
devin/1777565083-add-multi-source-docs

Conversation

@devin-ai-integration
Copy link
Copy Markdown
Contributor

@devin-ai-integration devin-ai-integration Bot commented Apr 30, 2026

Summary

Adds a new documentation page for the multi-source docs feature, which lets multiple teams publish to the same custom domain from independent repositories.

Changes

  • New page: fern/products/docs/pages/preview-publish/multi-source.mdx — covers:
    • Enterprise-only warning at the top
    • How multi-source: true on instances enables basepath-aware publishing
    • How global themes (fern docs theme export/upload/list) keep branding consistent across repos
    • Dashboard multi-source settings for default path and search behavior (hierarchical vs unified)
    • Full setup guide with Steps, Tabs, and a worked example (homepage + 3 teams with 4 repos)
  • Navigation: Added the page to the "Preview & publish" section in docs.yml
  • Site-level settings: Added instances.multi-source ParamField to the instances configuration reference
  • Changelog: Added 2026-04-30.mdx entry for the feature
  • Screenshot: Dashboard multi-source settings screenshot (text updated to "Multi-source settings")

Review & Testing Checklist for Human

  • Verify the multi-source page renders correctly in the preview deployment — check Steps, Tabs, Warning, CardGroup example, image, and ParamField components
  • Confirm the screenshot of dashboard multi-source settings accurately represents the current UI
  • Check that all internal links resolve (/learn/docs/customization/global-themes, /learn/docs/preview-publish/multi-source, etc.)
  • Verify the changelog entry appears on the changelog page

Notes

  • The page is placed under "Preview & publish" since multi-source is an extension of the publishing workflow.
  • The instances.multi-source property replaces the deprecated experimental.basepath-aware flag (added in CLI 5.2.0).
  • Cross-references the existing Global themes page rather than duplicating theme setup instructions.
  • The example section demonstrates the recommended "homepage + 3 teams" pattern with 4 separate fern/ projects.

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

Co-Authored-By: kenny <kenny@buildwithfern.com>
@devin-ai-integration devin-ai-integration Bot requested a review from devalog as a code owner April 30, 2026 16:07
@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 and CI monitoring

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 30, 2026

devin-ai-integration Bot and others added 4 commits April 30, 2026 16:11
Co-Authored-By: kenny <kenny@buildwithfern.com>
Co-Authored-By: kenny <kenny@buildwithfern.com>
Co-Authored-By: kenny <kenny@buildwithfern.com>
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