Skip to content

Commit bfbb167

Browse files
committed
format troubleshooting steps
1 parent 26b9cd5 commit bfbb167

File tree

1 file changed

+10
-5
lines changed

1 file changed

+10
-5
lines changed

installation.mdx

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -123,18 +123,23 @@ If you use JetBrains, we recommend the [MDX IntelliJ IDEA plugin](https://plugin
123123
3. Reinstall the mint CLI: `npm install -g mint`
124124
</Accordion>
125125
<Accordion title="Issue: Encountering an unknown error">
126-
Solution: Go to the root of your device and delete the `~/.mintlify` folder. Afterwards, run `mint dev` again.
126+
**Solution**: Go to the root of your device and delete the `~/.mintlify` folder. Afterwards, run `mint dev` again.
127127
</Accordion>
128128
<Accordion title="Error: permission denied">
129129
This is due to not having the required permissions to globally install node packages.
130-
Solution: Try running `sudo npm i -g mint`. You will be prompted for your password, which is the one you use to unlock your computer.
130+
131+
**Solution**: Try running `sudo npm i -g mint`. You will be prompted for your password, which is the one you use to unlock your computer.
131132
</Accordion>
132133
<Accordion title="The local preview doesn't look the same as my docs do on the web">
133-
Likely this is due to an outdated version of the CLI.
134-
Solution: Run `mint update` to get the latest changes.
134+
This is likely due to an outdated version of the CLI.
135+
136+
**Solution:** Run `mint update` to get the latest changes.
135137
</Accordion>
136138
<Accordion title="mintlify vs. mint package">
137-
When having any problems with the CLI package, the first thing we'll ask you to do when troubleshooting is paste the output of `npm ls -g`, which shows what packages are globally installed on your machine. You may see that you have a package named "mint" and a package named "mintlify" installed. It will be less confusing to have only one of them installed.
139+
If you have any problems with the CLI package, you should first run `npm ls -g`. This command shows what packages are globally installed on your machine.
140+
141+
If you have a package named `mint` and a package named `mintlify` installed, you should uninstall `mintlify`.
142+
138143
1. Uninstall the old package:
139144
```bash
140145
npm uninstall -g mintlify

0 commit comments

Comments
 (0)