Document monorepo and multi-repo SDK reference setups - #6844
Merged
Conversation
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
hahnbeelee
reviewed
Aug 1, 2026
|
|
||
| The simplest setup. Generate the artifact in the same repository as your docs and point `source` at its relative path. Any workflow that already produces the artifact on push or release can commit it back to the repository, and the next docs deployment picks it up automatically. | ||
|
|
||
| This works for a monorepo that contains both the SDK source and the docs, or for a docs repository that vendors the SDK as a submodule. |
Member
There was a problem hiding this comment.
@mintlify , or for a docs repository that vendors the SDK as a submodule get rid of this part of the sentence
Contributor
Author
There was a problem hiding this comment.
Removed the submodule clause from the same-repo pattern description.
hahnbeelee
reviewed
Aug 1, 2026
Comment on lines
+133
to
+135
| **Commit the artifact to your docs repository.** In the SDK repository, run a CI job on release that generates the artifact and opens a pull request (or pushes a commit) to your docs repository with the updated file. Merging that change to your deployment branch triggers a docs deployment on its own, so no extra API call is needed. Point `source` at the committed path, the same as the single-repository setup. | ||
|
|
||
| **Host the artifact and fetch it at build time.** Upload the artifact to a stable HTTPS URL (for example, an S3 bucket, GitHub Releases asset, or Maven Central for Javadoc jars) and set `source` to that URL. Because nothing changes in your docs repository when the SDK updates, you also need to trigger a docs deployment so the new artifact is fetched. Call the [Trigger deployment](/api/update/trigger) endpoint from your SDK release pipeline after the artifact is published. See [Remote artifact limits](#use-remote-sources) for size constraints. |
Contributor
Author
There was a problem hiding this comment.
Numbered the two separate-repo SDK artifact options as an ordered list.
ethanpalm
approved these changes
Aug 3, 2026
ethanpalm
left a comment
ethanpalm
left a comment
Collaborator
There was a problem hiding this comment.
pushed some copy edits. lgtm!
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documentation changes
Adds a "Where your SDK code lives" section to the SDK reference setup page covering monorepo and multi-repo scenarios: SDK in the same repo as docs, SDK in a separate repo with the artifact committed to docs, and SDK in a separate repo with the artifact hosted remotely (with a callout that the latter needs a Trigger deployment API call after publish).
Closes
For Reviewers
When reviewing documentation PRs, please consider:
✅ Technical accuracy
✅ Clarity and completeness
✅ User experience
Generated by Mintlify Agent.
Requested by: hahnbee@mintlify.com via Slack
Mintlify session: slack_1785613194.223009_C0A6A37P2AK
Note
Low Risk
Documentation-only changes with no runtime or configuration behavior impact.
Overview
Adds a Repository setup section to the SDK reference setup guide, explaining how to wire SDK doc artifacts when code lives in the same repo as docs versus a separate SDK repo.
For monorepo-style layouts, it documents pointing
sourceat a relative artifact path (with a sampledocs-repo/tree). For multi-repo setups, it covers committing generated artifacts into the docs repo via release CI versus hosting artifacts at a stable HTTPS URL and using the Trigger deployment API after publish. A Tip helps readers choose between commit vs remote fetch based on release cadence, artifact size, and existing publishing (e.g. Maven Central Javadoc jars).Reviewed by Cursor Bugbot for commit 6345c02. Bugbot is set up for automated code reviews on this repo. Configure here.