Add multi-source example with homepage + 3 sub-paths

README.md

@@ -10,6 +10,7 @@ Example Fern docs projects. Each top-level folder is a self-contained example wi
 | --- | --- | --- |
 | [`docs-starter`](./docs-starter) | Minimal starter project | [docs-starter.docs.buildwithfern.com](https://docs-starter.docs.buildwithfern.com) |
 | [`i18n`](./i18n) | Multi-language docs with English + Japanese translations | [i18n.docs.buildwithfern.com](https://i18n.docs.buildwithfern.com) |
+| [`multi-source`](./multi-source) | Multiple teams publishing to one domain from separate repos | [multi-source.docs.buildwithfern.com](https://multi-source.docs.buildwithfern.com) |
 | [`versioning`](./docs-versioned) | Versioned site with a version dropdown and a shared page | [versioning.docs.buildwithfern.com](https://versioning.docs.buildwithfern.com) |
 
 ## Use an example

multi-source/README.md

@@ -0,0 +1,38 @@
+# Multi-source docs
+
+This example shows how multiple teams can publish to the same custom domain from independent repositories using Fern's [multi-source docs](https://buildwithfern.com/learn/docs/preview-publish/multi-source-docs) feature.
+
+## Structure
+
+In production, each folder would be its own repository. They are grouped here for demonstration:
+
+```
+multi-source/
+├── homepage/     # Root of the domain — landing page with cards linking to each team
+├── seeds/        # /seeds sub-path — seed catalog and planting guides
+├── greenhouses/  # /greenhouses sub-path — climate control and monitoring
+└── nursery/      # /nursery sub-path — plant care and propagation
+```
+
+Each folder contains a standalone `fern/` project with its own `docs.yml` and content. All four projects:
+
+- Target the same base domain (`multi-source.docs.buildwithfern.com`)
+- Set `multi-source: true` on their instance
+- Share the same colors and logo (in production, use a [global theme](https://buildwithfern.com/learn/docs/customization/global-themes) instead of duplicating branding)
+
+## Publishing
+
+Each project publishes independently:
+
+```bash
+cd homepage && fern generate --docs
+cd seeds && fern generate --docs
+cd greenhouses && fern generate --docs
+cd nursery && fern generate --docs
+```
+
+Updating one sub-path has no effect on the others.
+
+## Learn more
+
+See the [multi-source docs guide](https://buildwithfern.com/learn/docs/preview-publish/multi-source-docs) for the full setup instructions, including global themes and Dashboard configuration.