mintlify / docs

🪴 Mintlify's documentation

🌿 Mintlify Connector

Mintlify helps teams easily track and manage documentation.

🚀 Get Started

🎥 Demo

🔗 Create links between code and documentation

Connect documentation to code and receive alerts to update your documentation when the code changes

🔌 Integrations

We are currently integrated with:

• Notion
• Google Docs
• Confluence
• GitHub
• Slack

---

More information

Website Twitter Discord

Built with 💚 by the Mintlify team

docs's Issues

How to add a multilingual document?

How to add a multilingual document?

like this:

eg:
English: https://mintlify.com/en/docs/quickstart
Chinese: https://mintlify.com/zh/docs/quickstart

Issue on docs: wrong external link

Path: /settings/global

wrong external link: https://fontawesome.com/search?s=brands%2Cduotone

When I click the Font Awesome link in the picture below, the page behaves strangely.

Get started button takes you to 404 page

https://mintlify.com/docs/introduction

How to customize SEO default values in `mint.json`?

The SEO documentation page mentions that we can customize the SEO default value globally (ex: og:image) in the mint.json file; however, I don't find such parameters in the mint.json documentation page.

Expand Object Properties doesn't work with paramfield

Path: /components/api/expandable

Ability to provide custom React components?

Hi!

Coming from Nextra, I have some custom React components (ex: "Retries simulator", "Get your API token") that I need now to either drop or integrate with an iframe.

Is there any plan to support custom React components that could rely on styled-components or similar?

Thanks!

Error 500 on internal pages when hosted on Mintlify

Local mintlify dev renders pages fine.

Online, I am getting a 500 server error on the subpages: https://uitrial.mintlify.app/api-reference/example-usage. The issue persists for 24 hours now, and no reads or replies from Mintlify support team?

What's going on?

Future request: tab-able API accordion items

Please make these tab-able and open-able by keyboard for accessibility reasons, thank you.

Bug: Doc linking to the wrong place?

on this page https://mintlify.com/docs/api-playground/components/api/param. Clicking the API Playground links to the docs home page. I think its linking to a different page, can you please confirm that.

Feature Request: Add producthunt to footer socials

Can producthunt please be added as a footerSocial in mint.json?

Missing the Workflow?

Knowing nothing about Mintlify except that the beautiful sites it produces, I jumped in. I was hoping on the QuickStart page to see something about "mintlify generate" or some idea of how one creates the documents apart from just hand coding MDX. As far as I can tell from the docs site, it's a sort of static site generator targetting documentation, but given there is a Mintlify Writer generating code comments and other references, it seems like there is some connection between source code and the generated sites but I can't tell how. Anyhoo, still a beautiful site.

Snippets error

Hello! I'm testing out your docs solution (pretty cool!) but running into an issue with Snippets. The docs say there's no importing or special pathing required, but the error I'm getting implies otherwise. I've tried to make my own snippet and also just copy/paste the snippet in the docs.

sidenote: are snippets the best way for me to handle global doc variables? For example, I tend to support documentation that has an open source version and an enterprise version that sometimes has another product name, so I like to just pass something like {{% productName %}} into my Hugo docs.

Server Error
Error: Expected component `Snippet` to be defined: you likely forgot to import, pass, or provide it.
It’s referenced in your code at `4:27-4:60`

This error happened while generating the page. Any console logs will be displayed in the terminal window.
Call Stack
_missingMdxReference
eval at <anonymous> (webpack-internal:///./node_modules/next-mdx-remote/dist/index.js), <anonymous> (232:9)
_createMdxContent
eval at <anonymous> (webpack-internal:///./node_modules/next-mdx-remote/dist/index.js), <anonymous> (36:17)
renderWithHooks
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (7766:16)
renderIndeterminateComponent
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (7840:15)
renderElement
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8075:7)
renderNodeDestructiveImpl
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8243:11)
renderNodeDestructive
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8215:14)
renderContextProvider
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8039:3)
renderElement
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8153:11)
renderNodeDestructiveImpl
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8243:11)
renderNodeDestructive
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8215:14)
renderIndeterminateComponent
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (7894:7)
renderElement
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8075:7)
renderNodeDestructiveImpl
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8243:11)
renderNodeDestructive
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8215:14)
renderNode
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8399:12)
renderChildrenArray
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8351:7)
renderNodeDestructiveImpl
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8280:7)
renderNodeDestructive
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8215:14)
renderNode
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8399:12)
renderHostElement
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (7750:3)
renderElement
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8081:5)
renderNodeDestructiveImpl
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8243:11)
renderNodeDestructive
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8215:14)
renderIndeterminateComponent
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (7894:7)
renderElement
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8075:7)
renderNodeDestructiveImpl
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8243:11)
renderNodeDestructive
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8215:14)
renderNode
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8399:12)
renderChildrenArray
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8351:7)
renderNodeDestructiveImpl
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8280:7)
renderNodeDestructive
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8215:14)
renderNode
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8399:12)
renderHostElement
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (7750:3)
renderElement
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8081:5)
renderNodeDestructiveImpl
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8243:11)
renderNodeDestructive
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8215:14)
renderNode
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8399:12)
renderChildrenArray
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8351:7)
renderNodeDestructiveImpl
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8280:7)
renderNodeDestructive
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8215:14)
renderNode
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8399:12)
renderHostElement
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (7750:3)
renderElement
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8081:5)
renderNodeDestructiveImpl
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8243:11)
renderNodeDestructive
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8215:14)
renderIndeterminateComponent
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (7894:7)
renderElement
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8075:7)
renderNodeDestructiveImpl
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8243:11)
renderNodeDestructive
file:///Users/lanel/.mintlify/mint/client/node_modules/next/dist/compiled/react-dom/cjs/react-dom-server.browser.development.js (8215:14)

Provide mint.json configuration option to customise suggest edit branch

Problem

Novu docs (https://github.com/novuhq/docs) use a Gitflow branching model with 2 primary branches. All changes first make their way into a trunk branch, and the trunk is periodically merged into the Mintlify deploy branch.

By default, the Mintlify "Suggest edit" feature opens the Github edit page on the deploy branch for the docs, which for repositories using a Gitflow branching model, is the incorrect branch for edits to be made on. This results in poor contributor DX and can result in edits erroneously being pushed against the deploy branch if branch merge checks are not enforced.

Proposed Feature

The mint.json should provide an optional feedback.suggestEditBranch configuration option to enable customisation of the "Suggest edits" branch. If the optional configuration option is not provided, the auto-generated repo.github.deployBranch option should be used.

Proposed Solution

The useUserFeedBack hook can be updated with the following code to support this backward compatible change:

const { suggestEditBranch } = mintConfig?.feedback;
let editBranch;
if (suggestEditBranch) {
    editBranch = suggestEditBranch;
} else {
    editBranch = deployBranch;
}
...
dispatch({
    type: FeedBackActionEnum.SET_CREATE_SUGGEST_HREF,
    payload: `https://github.com/${owner}/${repo}/edit/${editBranch}/${removeFirstSlash(urlPath)}${removeFirstSlash(`${path}.mdx`)}`
});

Who will benefit from this feature?

• Mintlify customers using a Gitflow branching model to manage changes
• Mintlify customers preferring suggested edits to be made against a custom branch
• Contributors to public documentation using the Mintlify platform

I am willing to contribute to the https://github.com/mintlify/docs to support this feature.

Issue on docs: Local development instructions are missing steps

Path: /development

The docs say just run npm i -g mintlify and then run mintlify dev. That did not work for me.

After doing the NPM install I ran mintlify dev and it asked me to install Yarn. Not really what I wanted, but there was no way around it, so I did.
I then ran mintlify dev again, this time I got:

? yarn must be globally installed. Install yarn? Yes

added 1 package in 830ms
✖ Dependencies were not installed correctly, run
  
      mintlify install
      

So I ran that. It installed another boatload of packages.

Then finally did mintlify dev actually succeed.

I think the docs should mention that yarn is a required dependency (if that is necessary, I would prefer it was not) and the additional command you need to run to install dependencies first.

`hideFeedbackButtons` seems not working

According to the documentation on Global Settings, there is an option called hideFeedbackButtons that allows the hiding of suggestion buttons at the top of pages. However, setting it to true does not seem to disable those buttons.

Furthermore, this option is missing in schema.json. Perhaps this flag has not yet been published to production?