docs

Welcome to Axiom’s documentation repo. It contains everything under the axiom.co/docs subpath. It’s a collaborative space open to feedback and contributions.

The repo is based on the Mintlify framework and the content is in Markdown format. For more information, see Mintlify documentation.

Setup

1. Install the latest LTS version of Node.js.

2. Install Vale.

3. Install Mint CLI.

4. Fork this repo, and then clone it. For more information, see the GitHub documentation.

5. Run the following in your terminal to sync the Vale style packages.

   vale sync
   

Optional: install the following VS Code extensions:

• Code Spell Checker
• MDX
• Vale VSCode

Build locally

Run the following in your terminal to build the documentation locally:

mint dev

Check for broken links

Run the following in your terminal to check for broken links:

mint broken-links

Ensure consistent style

Run the following in your terminal to check the style of a file:

vale example.mdx

Run the following in your terminal to check the style of all files in the current folder and its subfolders:

vale .

Contribute

We value your input and invite you to help us make the Axiom documentation even better. Here’s how you can get involved:

1. Rate pages. Hit the 👍/👎 button on any page to let us know what you like and what you don’t.
2. Leave feedback. Click Raise issue on any documentation page to create a GitHub issue where you can share thoughts and suggestions.
3. Suggest edits. Found a typo or outdated information? Click Suggest edits directly on the page.
4. Contribute content. If you have in-depth knowledge or unique use cases, we encourage you to contribute by writing new sections or enhancing existing ones. Before contributing, please read the Contribution guidelines and the Contributor Covenant.

Troubleshooting

• If the local build fails, run mint update.
• If a page loads as a 404, make sure you run the local build in the root folder where the file docs.json is present.