How to Write MindsDB Documentation

This section gets you started on how to contribute to the MindsDB documentation.

MindsDB’s documentation is run using Mintlify. If you want to contribute to our docs, please follow the steps below to set up the environment locally.

​

Running the Docs Locally

Step 1. Clone the MindsDB Git repository:

git clone https://github.com/mindsdb/mindsdb.git

Step 2. Install Mintlify on your OS:

npm i mintlify -g

Step 3. Go to the docs folder inside the cloned MindsDB Git repository and start Mintlify there:

mintlify dev

The documentation website is now available at http://localhost:3000.

​

MindsDB Repository Structure

Here is the structure of the MindsDB docs repository:

docs                          # All documentation source files
|__assets/                    # Images and icons used throughout the docs
│  ├─ ...
│__folders_with_mdx_files/    # All remaining folders that store the .mdx files
|__mdx_files                  # Some of the .mdx files are stored in the docs directory
|__mintlify.json              # This JSON file stores navigation and page setup

​

What’s Next?

Follow our docs rules and have fun.

Thank you for contributing to the MindsDB docs!