Skip to content

Commit 5abd443

Browse files
devin-ai-integration[bot]kenny
andcommitted
docs: add enterprise tag and homepage + 3 teams example
Co-Authored-By: kenny <kenny@buildwithfern.com>
1 parent 2204ef5 commit 5abd443

1 file changed

Lines changed: 57 additions & 4 deletions

File tree

fern/products/docs/pages/preview-publish/multi-source.mdx

Lines changed: 57 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ subtitle: Let multiple teams publish to the same docs site from their own reposi
44
description: Learn how to set up multi-source documentation so independent teams can publish to shared domains with consistent branding using Fern.
55
---
66

7+
<Markdown src="/snippets/enterprise-plan.mdx" />
8+
79
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).
810

911
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:
98100

99101
</Steps>
100102

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
102111
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
104116
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:
123+
124+
```jsx home.mdx
125+
<CardGroup>
126+
<Card title="AI Performance" icon="fa-regular fa-gauge" href="https://docs.acme.com/aiperf">
127+
Benchmarking and optimization tools.
128+
</Card>
129+
<Card title="AI Store" icon="fa-regular fa-store" href="https://docs.acme.com/aistore">
130+
Model marketplace and deployment.
131+
</Card>
132+
<Card title="Dynamo" icon="fa-regular fa-bolt" href="https://docs.acme.com/dynamo">
133+
Real-time inference engine.
134+
</Card>
135+
</CardGroup>
136+
```
137+
</Tab>
138+
<Tab title="Team A">
105139
```yaml Team A — docs.yml
106140
global-theme: acme-theme
107141
@@ -116,7 +150,8 @@ navigation:
116150
- page: Overview
117151
path: ./pages/overview.mdx
118152
```
119-
153+
</Tab>
154+
<Tab title="Team B">
120155
```yaml Team B — docs.yml
121156
global-theme: acme-theme
122157
@@ -131,8 +166,26 @@ navigation:
131166
- page: Overview
132167
path: ./pages/overview.mdx
133168
```
169+
</Tab>
170+
<Tab title="Team C">
171+
```yaml Team C — docs.yml
172+
global-theme: acme-theme
173+
174+
instances:
175+
- url: acme-dynamo.docs.buildwithfern.com/dynamo
176+
custom-domain: docs.acme.com/dynamo
177+
multi-source: true
178+
179+
navigation:
180+
- section: Getting started
181+
contents:
182+
- page: Overview
183+
path: ./pages/overview.mdx
184+
```
185+
</Tab>
186+
</Tabs>
134187

135-
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.
136189

137190
## Properties
138191

0 commit comments

Comments
 (0)