Update installation page content

Author: handotdev

installation.mdx

@@ -5,7 +5,7 @@ icon: "terminal"
 ---
 
 <Info>
-  **Prerequisite**: Please install Node.js (version 19 or higher) before proceeding.
+  **Prerequisite**: Please install [Node.js](https://nodejs.org/en) (version 19 or higher) before proceeding.
 </Info>
 
 **Step 1**: Install the Mintlify CLI:
@@ -34,7 +34,7 @@ pnpm add -g mintlify
 mintlify dev
 ```
 
-Alternatively, if you do not want to install the CLI globally you can use a run script available:
+Alternatively, if you do not want to install the CLI globally, you can use a run a one-time script:
 
 <CodeGroup>
 
@@ -56,23 +56,9 @@ pnpm dlx mintlify dev
 
 A local preview of your documentation will be available at `http://localhost:3000`.
 
-### Custom Ports
+## Updates
 
-By default, Mintlify uses port 3000. You can customize the port using the `--port` flag. To run Mintlify on port 3333, for instance, use this command:
-
-```bash
-mintlify dev --port 3333
-```
-
-If you attempt to run on a port that's already in use, it will use the next available port:
-
-```md
-Port 3000 is already in use. Trying 3001 instead.
-```
-
-## Versions
-
-Please note that each CLI release is associated with a specific version of Mintlify. If your local website doesn't align with the production version, please update the CLI:
+Each CLI release is associated with a specific version of Mintlify. If your local preview doesn't align with the production version, please update the CLI:
 
 <CodeGroup>
 
@@ -92,28 +78,59 @@ pnpm up --global mintlify
 
 </CodeGroup>
 
-## Validating Links
+## Custom Ports
+
+By default, the CLI uses port 3000. You can customize the port using the `--port` flag. To run the CLI on port 3333, for instance, use this command:
+
+```bash
+mintlify dev --port 3333
+```
+
+If you attempt to run on a port that's already in use, it will use the next available port:
+
+```md
+Port 3000 is already in use. Trying 3001 instead.
+```
+
+## Additional Commands
+
+While `mintlify dev` is the most commonly used command, there are other commands you can use to manage your documentation.
+
+### Find Broken Links
 
 The CLI can assist with validating reference links made in your documentation. To identify any broken links, use the following command:
 
 ```bash
 mintlify broken-links
 ```
 
-## Deployment
+### Check OpenAPI Spec
+
+You can use the CLI to check your OpenAPI file for errors using the following command:
+
+```bash
+mintlify openapi-check <openapiFilenameOrUrl>
+```
+
+You can pass in a filename (e.g. `./openapi.yaml`) or a URL (e.g. `https://petstore3.swagger.io/api/v3/openapi.json`).
+
+### Rename Files
+
+You can rename files using the following command:
+
+```bash
+mintlify rename <oldFilename> <newFilename>
+```
+
+This is an improvement over updating the filename normally as it will also update all references to the file, ensuring no broken links.
 
-If the deployment is successful, you should see the following:
+## Formatting
 
-<Frame>
-  <img
-    className="rounded-md"
-    src="https://mintlify.s3-us-west-1.amazonaws.com/mintlify/images/checks-passed.png"
-  />
-</Frame>
+While developing locally, we recommend using extensions on your IDE to recognize and format MDX.
 
-## Code Formatting
+If you use Cursor, Windsurf, or VSCode, we recommend the [MDX VSCode extension](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx) for syntax highlighting, and [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) for code formatting.
 
-We suggest using extensions on your IDE to recognize and format MDX. If you're a VSCode user, consider the [MDX VSCode extension](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx) for syntax highlighting, and [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) for code formatting.
+If you use JetBrains, we recommend the [MDX IntelliJ IDEA plugin](https://plugins.jetbrains.com/plugin/14944-mdx) for syntax highlighting, and setting up [Prettier](https://prettier.io/docs/webstorm) for code formatting.
 
 ## Troubleshooting