docs/improve install docs

docs/docs/install/linux.md

@@ -2,15 +2,29 @@
 title: Linux
 ---
 
-# Jan on Linux
+# Installing Jan on Linux
 
 ## Installation
 
-1. To download the lastest version of Jan on Linux, please visit the [Jan's homepage](https://jan.ai/).
-2. For Debian/Ubuntu-based distributions, the recommended installation method is through the `.deb` package (64-bit). This can be done either through the graphical software center, if available, or via the command line using the following:
+Jan is available for download via our homepage, [https://jan.ai](https://jan.ai/).
+
+For Linux, the download should be available as a `.deb` file in the following format. 
+
+```bash
+jan-linux-amd64-{version}.deb
+```
+
+The typical installation process takes around a minute. 
+
+### GitHub Releases
+
+Jan is also available from [Jan's GitHub Releases](https://github.com/janhq/jan/releases) page, with a recommended [latest stable release](https://github.com/janhq/jan/releases/latest). 
+
+Within the Releases' assets, you will find the following files for Linux:
+
 ```bash
-sudo apt install ./jan-linux-amd64-<version>.deb
-# sudo apt install ./jan-linux-arm64-0.3.1.deb
+# Debian Linux distribution
+jan-linux-amd64-{version}.deb
 ```
 
 ## Uninstall Jan

docs/docs/install/mac.md

@@ -2,13 +2,37 @@
 title: Mac
 ---
 
-# Jan on MacOS
+# Installing Jan on MacOS
 
 ## Installation
-1. To download the lastest version of Jan on MacOS, please visit the [Jan's homepage](https://jan.ai/).
-2. On the homepage, please choose the appropriate release version for your system architecture as follows:
-    - Intel Mac: `jan-mac-x64-<version>.dmg`
-    - Apple Silicon Mac: `jan-mac-arm64-<version>.dmg`
+
+Jan is available for download via our homepage, [https://jan.ai/](https://jan.ai/).
+
+For MacOS, the download should be available as a `.dmg` file in the following format.
+
+```bash
+# Intel Mac 
+jan-mac-x64-{version}.dmg
+# Apple Silicon Mac
+jan-mac-arm64-{version}.dmg
+```
+
+The typical installation process taks around a minute.
+
+## GitHub Releases
+Jan is also available from [Jan's GitHub Releases](https://github.com/janhq/jan/releases) page, with a recommended [latest stable release](https://github.com/janhq/jan/releases/latest). 
+
+Within the Releases' assets, you will find the following files for MacOS:
+
+```bash
+# Intel Mac (dmg file and zip file)
+jan-mac-x64-{version}.dmg
+jan-mac-x64-{version}.zip
+
+# Apple Silicon Mac (dmg file and zip file)
+jan-mac-arm64-{version}.dmg
+jan-mac-arm64-{version}.zip
+```
 
 ## Uninstall Jan
 As Jan is development mode, you might get stuck on a broken build

docs/docs/install/windows.md

@@ -16,9 +16,9 @@ jan-win-x64-{version}.exe
 
 The typical installation process takes around a minute. 
 
-### Github Releases
+### GitHub Releases
 
-Jan is also available from [Jan's Github Releases](https://github.com/janhq/jan/releases) page, with a recommended [latest stable release](https://github.com/janhq/jan/releases/latest). 
+Jan is also available from [Jan's GitHub Releases](https://github.com/janhq/jan/releases) page, with a recommended [latest stable release](https://github.com/janhq/jan/releases/latest). 
 
 Within the Releases' assets, you will find the following files for Windows:
 

docs/docs/intro/introduction.md

@@ -1,6 +1,6 @@
 ---
 title: Introduction
-slug: /intro
+slug: /docs
 ---
 
 Jan is a ChatGPT-alternative that runs on your own computer, with a [local API server](/api).