docs: add troubleshooting (#1169)

docs: add troubleshooting

docs/docs/guides/02-installation/01-mac.md

@@ -50,7 +50,7 @@ jan-mac-arm64-{version}.zip
 
 ## Uninstall Jan
 
-As Jan is development mode, you might get stuck on a broken build
+As Jan is development mode, you might get stuck on a broken build.
 To reset your installation
 
 1. Delete Jan from your `/Applications` folder

docs/docs/guides/02-installation/03-linux.md

@@ -42,10 +42,10 @@ jan-linux-amd64-{version}.deb
 
 ## Uninstall Jan
 
-To uninstall VS Code on Linux, you should use your package manager's uninstall or remove option. For Debian/Ubuntu-based distributions, if you installed Jan via the `.deb` package, you can uninstall Jan using the following command:
+To uninstall Jan on Linux, you should use your package manager's uninstall or remove option. For Debian/Ubuntu-based distributions, if you installed Jan via the `.deb` package, you can uninstall Jan using the following command:
 
 ```bash
-sudo apt-get remove jan`
+sudo apt-get remove jan
 # where jan is the name of Jan package
 ```
 

docs/docs/guides/07-troubleshooting/01-stuck-on-broken-build.mdx

@@ -0,0 +1,121 @@
+---
+title: Stuck on a Broken Build
+slug: /troubleshooting/stuck-on-broken-build
+description: Jan is a ChatGPT-alternative that runs on your own computer, with a local API server.
+keywords:
+  [
+    Jan AI,
+    Jan,
+    ChatGPT alternative,
+    local AI,
+    private AI,
+    conversational AI,
+    no-subscription fee,
+    large language model,
+    troubleshooting,
+  ]
+---
+
+{/* Imports */}
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+The following steps will help you troubleshoot and resolve issues related to broken builds.
+
+1. Unistall Jan
+
+<Tabs groupId="operating-systems">
+  <TabItem value="mac" label="macOS">
+    
+    Delete Jan from your `/Applications` folder
+  
+  </TabItem>
+  <TabItem value="win" label="Windows">
+
+    To uninstall Jan in Windows, use the [Windows Control Panel](https://support.microsoft.com/en-us/windows/uninstall-or-remove-apps-and-programs-in-windows-4b55f974-2cc6-2d2b-d092-5905080eaf98).
+
+  </TabItem>
+  <TabItem value="linux" label="Linux">
+
+    To uninstall Jan on Linux, you should use your package manager's uninstall or remove option. For Debian/Ubuntu-based distributions, if you installed Jan via the `.deb` package, you can uninstall Jan using the following command:
+    ```bash
+    sudo apt-get remove jan
+    ```
+
+  </TabItem>
+</Tabs>
+
+2. Delete the application data, cache, and user data folders
+
+<Tabs groupId="operating-systems">
+  <TabItem value="mac" label="macOS">
+    
+    ```bash
+    # Step 1: Delete the application data
+    ## Newer versions
+    rm -rf /Users/$(whoami)/Library/Application\ Support/jan
+    ## Versions 0.2.0 and older
+    rm -rf /Users/$(whoami)/Library/Application\ Support/jan-electron
+    
+    # Step 2: Clear application cache
+    rm -rf /Users/$(whoami)/Library/Caches/jan*
+
+    # Step 3: Remove all user data
+    rm -rf ./jan
+    ```
+
+  </TabItem>
+  <TabItem value="win" label="Windows">
+  
+    ```bash
+    # You can delete the `/Jan` directory in Windows's AppData Directory by visiting the following path `%APPDATA%\Jan`
+    cd C:\Users\%USERNAME%\AppData\Roaming
+    rm -rf ./Jan
+    ```
+  
+  </TabItem>
+  <TabItem value="linux" label="Linux">
+  
+    ```bash
+    # You can delete the user data folders located at the following `$HOME/.config/jan` and `~/.jan`
+    rm -r $HOME/.config/jan
+    rm -r ~/.jan
+    ```
+  
+  </TabItem>
+</Tabs>
+
+3. If you are using version before `0.4.2` you need to run the following commands
+
+<Tabs groupId="operating-systems">
+  <TabItem value="mac" label="macOS">
+    
+    ```bash
+    ps aux | grep nitro
+    # Looks for processes like `nitro` and `nitro_arm_64`, and kill them one by one by process ID
+    kill -9 <PID>
+    ```
+
+  </TabItem>
+  <TabItem value="win" label="Windows">
+  
+    ```bash
+    # Find the process ID (PID) of the nitro process by filtering the list by process name
+    tasklist | findstr "nitro"
+    # Once you have the PID of the process you want to terminate, run the `taskkill`
+    taskkill /F /PID <PID>
+    ```
+  
+  </TabItem>
+  <TabItem value="linux" label="Linux">
+  
+    ```bash
+    ps aux | grep nitro
+    # Looks for processes like `nitro` and `nitro_arm_64`, and kill them one by one by process ID
+    kill -9 <PID>
+    ```
+  
+  </TabItem>
+</Tabs>
+
+4. Download the latest version from via our homepage, [https://jan.ai/](https://jan.ai/).

docs/docs/guides/07-troubleshooting/README.md

@@ -0,0 +1,3 @@
+---
+title: Troubleshooting
+---