You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: fern/products/docs/pages/preview-publish/multi-source.mdx
+57-4Lines changed: 57 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,6 +4,8 @@ subtitle: Let multiple teams publish to the same docs site from their own reposi
4
4
description: Learn how to set up multi-source documentation so independent teams can publish to shared domains with consistent branding using Fern.
5
5
---
6
6
7
+
<Markdownsrc="/snippets/enterprise-plan.mdx" />
8
+
7
9
Multi-source documentation lets multiple teams publish to the same custom domain from independent repositories. Each team owns its own `docs.yml` and content, while a shared [global theme](/learn/docs/customization/global-themes) keeps branding consistent across every sub-path. Search and AI behavior can be configured per domain in the [Fern Dashboard](https://dashboard.buildwithfern.com).
8
10
9
11
This is useful when your organization has separate teams or products that each maintain their own documentation but need to present a unified site to end users, for example `docs.example.com/product-a` and `docs.example.com/product-b`.
@@ -98,10 +100,42 @@ Two search modes are available:
98
100
99
101
</Steps>
100
102
101
-
## Example
103
+
## Example setup with a homepage and three teams
104
+
105
+
A recommended pattern is to use four separate `fern/` projects — one for the homepage and one for each team. The homepage repository links out to each team's sub-path using cards or a product selector.
106
+
107
+
<Tabs>
108
+
<Tab title="Homepage">
109
+
```yaml Homepage — docs.yml
110
+
global-theme: acme-theme
102
111
103
-
An organization with two product teams might structure their multi-source setup as follows:
112
+
instances:
113
+
- url: acme.docs.buildwithfern.com
114
+
custom-domain: docs.acme.com
115
+
multi-source: true
104
116
117
+
navigation:
118
+
- page: Home
119
+
path: ./pages/home.mdx
120
+
```
121
+
122
+
The homepage `home.mdx` can use cards to direct users to each team's docs:
Both teams share `acme-theme` for consistent branding. Each publishes independently to its own basepath on `docs.acme.com`.
188
+
All four repositories share `acme-theme` for consistent branding. Each publishes independently — updating Team A's docs has no effect on the homepage or other teams.
0 commit comments