Add Mintlify integration page for Fern #1787
Merged
+39
−1
Conversation
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
- Create new integration page at fern/products/docs/pages/integrations/sdks/fern.mdx - Add navigation entry in docs.yml - Add Fern card to integrations overview page - Follow pattern from Speakeasy and Stainless integration pages Co-Authored-By: danny@buildwithfern.com <danny@buildwithfern.com>
Contributor
Author
🤖 Devin AI EngineerI'll be helping with this pull request! Here's what you should know: ✅ I will automatically:
Note: I can only respond to comments from users who have write access to this repository. ⚙️ Control Options:
|
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
| } | ||
| ``` | ||
|
|
||
| Fern-generated code snippets can now be viewed in your API docs and interacted with in the playground. |
Contributor
There was a problem hiding this comment.
[FernStyles.Current] Avoid time-relative terms like 'now' that become outdated
Contributor
Co-Authored-By: danny@buildwithfern.com <danny@buildwithfern.com>
Contributor
- Rename file from fern.mdx to mintlify.mdx - Update page title to 'Mintlify' - Update navigation entry in docs.yml - Update overview page card with Mintlify branding - Update slug from sdks/fern to sdks/mintlify Co-Authored-By: danny@buildwithfern.com <danny@buildwithfern.com>
Contributor
- Move mintlify.mdx from integrations/sdks/ to integrations/docs/ - Update content to be concise: generate SDKs with Fern → document with Mintlify - Update navigation in docs.yml to point to new docs/ location - Update overview page card href to new docs/ location - Add redirect from old /sdks/mintlify path to new /docs/mintlify path Co-Authored-By: danny@buildwithfern.com <danny@buildwithfern.com>
Contributor
dannysheridan
approved these changes
Nov 5, 2025
fern/docs.yml
Outdated
| destination: /learn/docs/getting-started/project-structure | ||
| - source: /learn/docs/alternatives/mintlify | ||
| destination: /learn/docs/getting-started/overview | ||
| - source: /learn/docs/integrations/sdks/mintlify |
fern/products/docs/docs.yml
Outdated
| path: ./pages/integrations/postman.mdx | ||
| - page: Mintlify | ||
| path: ./pages/integrations/docs/mintlify.mdx | ||
| slug: docs/mintlify |
- Remove slug: docs/mintlify from navigation - Remove redirect from /integrations/sdks/mintlify to /integrations/docs/mintlify Co-Authored-By: danny@buildwithfern.com <danny@buildwithfern.com>
Contributor
dannysheridan
approved these changes
Nov 5, 2025
fern/products/docs/docs.yml
Outdated
| - page: Postman | ||
| path: ./pages/integrations/postman.mdx | ||
| - page: Mintlify | ||
| path: ./pages/integrations/docs/mintlify.mdx |
|
|
||
| <Card | ||
| title="Mintlify" | ||
| href="/docs/integrations/docs/mintlify" |
- Move mintlify.mdx from integrations/docs/ to integrations/ - Update navigation path in docs.yml - Update overview card href from /docs/integrations/docs/mintlify to /docs/integrations/mintlify Co-Authored-By: danny@buildwithfern.com <danny@buildwithfern.com>
Contributor
dannysheridan
approved these changes
Nov 5, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Add Mintlify integration documentation
Summary
Added a concise documentation page explaining how to integrate Fern-generated SDKs with Mintlify documentation sites. The integration works by referencing Fern's OpenAPI spec (enriched with SDK code samples) in Mintlify's
docs.jsonconfiguration.Changes:
fern/products/docs/pages/integrations/mintlify.mdx(28 lines)Review & Testing Checklist for Human
https://registry.buildwithfern.com/{org}/{api-name}/openapi/openapi.jsonbut this infrastructure hasn't been implemented. Should this PR be merged before or after the registry is live? If merged now, users following these instructions will get 404 errors./learn/docs/integrations/mintlifyand check formatting, code blocks, and that it matches the concise style requested/learn/docs/integrations/overviewand clicking it navigates to the correct pageTest Plan
Notes
integrations/sdks/fern.mdx→ renamed tomintlify.mdxintegrations/docs/mintlify.mdx→ moved tointegrations/mintlify.mdx(no subdirectory)