diff --git a/installation.mdx b/installation.mdx index f0e43395d..a93371b50 100644 --- a/installation.mdx +++ b/installation.mdx @@ -1,6 +1,6 @@ --- title: "CLI installation" -description: "Install the CLI to preview and develop your docs locally" +description: "Use the CLI to preview and maintain your documentation locally" --- Decorative graphic representing the CLI. -## Installing the CLI +Use the CLI to preview your documentation locally as you write and edit. View changes in real-time before deploying, test your documentation site's appearance and functionality, and catch issues like broken links or accessibility problems. + +The CLI also has utilities for maintaining your documentation, including commands to rename files, validate OpenAPI specifications, and migrate content between formats. + +## Install the CLI - **Prerequisite**: Please install [Node.js](https://nodejs.org/en) before proceeding. + **Prerequisite**: The CLI requires [Node.js](https://nodejs.org/en) v19 or higher. - + Run the following command to install the [CLI](https://www.npmjs.com/package/mint): @@ -35,7 +39,7 @@ description: "Install the CLI to preview and develop your docs locally" - + Navigate to your docs directory (where your `docs.json` file is located) and execute the following command: ```bash @@ -86,7 +90,7 @@ If you attempt to run on a port that is already in use, it will use the next ava Port 3000 is already in use. Trying 3001 instead. ``` -## Previewing as a specific group +## Preview as a specific group If you use partial authentication to restrict access to your documentation, you can preview as a specific authentication group by using the `--groups [groupname]` flag. diff --git a/quickstart.mdx b/quickstart.mdx index 73d1d3c9f..967a25369 100644 --- a/quickstart.mdx +++ b/quickstart.mdx @@ -79,6 +79,10 @@ The code-based workflow integrates with your existing development environment an ### Install the CLI + + **Prerequisite**: The CLI requires [Node.js](https://nodejs.org/en) v19 or higher. + + To work locally with your documentation, install the Command Line Interface (CLI), called [mint](https://www.npmjs.com/package/mint), by running this command in your terminal: @@ -91,10 +95,6 @@ To work locally with your documentation, install the Command Line Interface (CLI ``` - - You need Node.js installed on your machine. If you encounter installation issues, check the troubleshooting guide. - - ### Edit the documentation After setting up your environment, you can start editing your documentation files. For example, update the title of the introduction page: