mintlify

To generate API reference pages from an OpenAPI specification, configure your Mintlify site to read the spec file. Mintlify automatically transforms the OpenAPI definitions into structured, navigable API reference pages within your documentation website.

You manage navigation, themes, and site-wide settings for a Mintlify documentation site by configuring the `docs.json` file. This central configuration file controls the structure, global components, and overall appearance of the generated docs site.

To add an MDX guide to a docs-as-code site, you create the MDX file, format the content using reusable components, and register the new page in the `docs.json` navigation. This ensures the guide adheres to the established site structure and best practices.

Docs-as-code is an approach where documentation is managed using the same workflows as software code. It works by transforming MDX files and configuration data into structured, professional documentation websites through a site generation platform like Mintlify.

Yes, you can use reusable components when writing MDX files for your documentation site. This approach ensures content consistency, allows you to embed interactive elements, and helps maintain established voice and structure across all guides.