fworks · August 12, 2025 14:25 · Mar 15, 2021 · Mar 15, 2021 · Feb 5, 2020 · Jan 9, 2020
diff --git a/install-zsh-windows-git-bash.md b/install-zsh-windows-git-bash.md
@@ -9,31 +9,35 @@ zsh-5.7.1-1-x86_64.pkg.tar.xz
 ```
 
 Update:
-The package now is compacted using `zstd`, so now we need some "special" extractor.
-So, in my case, I've downloaded this file 
+
+The package now is compacted using `zstd`, so now we need some "special" extractor.  
+So, in my case, I've downloaded this file  
 https://repo.msys2.org/msys/x86_64/zsh-5.8-5-x86_64.pkg.tar.zst
-And extracted it using the Peazip.
+And extracted it using the Peazip.  
 https://peazip.github.io/zst-compressed-file-format.html
 
-
 2) Extract the content to your git bash installation dir:
+
 Usually `C:\Program Files\Git`
 
 3) Test it and config zsh:
+
 Open git bash and type:
 ```
 zsh
 ```
 
-So, this step is important, it seems `zsh` will ask a few configurations, like the tab completion, history, etc.
+So, this step is important, it seems `zsh` will ask a few configurations, like the tab completion, history, etc.  
 Please read the options and set that according to your use.
 
 4) Installing oh-my-zsh, execute the following cmd on git bash
+
 ```shell
 sh -c "$(curl -fsSL https://raw.githubusercontent.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"
 ```
 
 5) Configuring zsh as default shell
+
 Edit the `~/.bashrc` file. (create it if it doesn't exist)
 
 Add the following lines at the end of the file
@@ -49,11 +53,13 @@ Close and open again the git bash.
 ## Optional steps
 
 6) Installing the Honukay theme
+
 ```shell
 curl -fsSL https://raw.githubusercontent.com/oskarkrawczyk/honukai-iterm/master/honukai.zsh-theme -o ~/.oh-my-zsh/custom/themes/honukai.zsh-theme
 ```
 
 7) Set it
+
 ```shell
 sed -i 's/ZSH_THEME="robbyrussell"/ZSH_THEME="honukai"/g' ~/.zshrc
 ```
diff --git a/install-zsh-windows-git-bash.md b/install-zsh-windows-git-bash.md
@@ -8,26 +8,33 @@ Example:
 zsh-5.7.1-1-x86_64.pkg.tar.xz
 ```
 
+Update:
+The package now is compacted using `zstd`, so now we need some "special" extractor.
+So, in my case, I've downloaded this file 
+https://repo.msys2.org/msys/x86_64/zsh-5.8-5-x86_64.pkg.tar.zst
+And extracted it using the Peazip.
+https://peazip.github.io/zst-compressed-file-format.html
+
+
 2) Extract the content to your git bash installation dir:
 Usually `C:\Program Files\Git`
 
-3) Test it, open git bash and type:
+3) Test it and config zsh:
+Open git bash and type:
 ```
 zsh
 ```
 
-4) If it start the zsh, it is working fine.
-
-`On some cases, there are stranger characters on the cmd line.
-It will get fixed when installing the oh-my-zsh`
+So, this step is important, it seems `zsh` will ask a few configurations, like the tab completion, history, etc.
+Please read the options and set that according to your use.
 
-5) Installing oh-my-zsh, execute the following cmd on git bash
+4) Installing oh-my-zsh, execute the following cmd on git bash
 ```shell
 sh -c "$(curl -fsSL https://raw.githubusercontent.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"
 ```
 
-6) Configuring zsh as default shell
-Edit the `~/.bashrc` file.
+5) Configuring zsh as default shell
+Edit the `~/.bashrc` file. (create it if it doesn't exist)
 
 Add the following lines at the end of the file
 
@@ -41,12 +48,12 @@ Close and open again the git bash.
 
 ## Optional steps
 
-7) Installing the Honukay theme
+6) Installing the Honukay theme
 ```shell
 curl -fsSL https://raw.githubusercontent.com/oskarkrawczyk/honukai-iterm/master/honukai.zsh-theme -o ~/.oh-my-zsh/custom/themes/honukai.zsh-theme
 ```
 
-8) Set it
+7) Set it
 ```shell
 sed -i 's/ZSH_THEME="robbyrussell"/ZSH_THEME="honukai"/g' ~/.zshrc
 ```
diff --git a/install-zsh-windows-git-bash.md b/install-zsh-windows-git-bash.md
@@ -18,7 +18,7 @@ zsh
 
 4) If it start the zsh, it is working fine.
 
-`On some cases, there are stranger characteres on the cmd line.
+`On some cases, there are stranger characters on the cmd line.
 It will get fixed when installing the oh-my-zsh`
 
 5) Installing oh-my-zsh, execute the following cmd on git bash

diff --git a/install-zsh-windows-git-bash.md b/install-zsh-windows-git-bash.md
@@ -39,7 +39,7 @@ fi
 ```
 Close and open again the git bash.
 
-## optional steps
+## Optional steps
 
 7) Installing the Honukay theme
 ```shell

diff --git a/readme.md → install-zsh-windows-git-bash.md b/readme.md → install-zsh-windows-git-bash.md
@@ -18,8 +18,8 @@ zsh
 
 4) If it start the zsh, it is working fine.
 
-`On some cases, there are a stranger characteres on the cmd line.
-It will get fix when installing the oh-my-zsh`
+`On some cases, there are stranger characteres on the cmd line.
+It will get fixed when installing the oh-my-zsh`
 
 5) Installing oh-my-zsh, execute the following cmd on git bash
 ```shell
@@ -37,6 +37,7 @@ if [ -t 1 ]; then
 exec zsh
 fi
 ```
+Close and open again the git bash.
 
 ## optional steps
 

diff --git a/readme.md b/readme.md
@@ -0,0 +1,51 @@
+## Steps:
+
+1) Download the latest zsh package:
+https://packages.msys2.org/package/zsh?repo=msys&variant=x86_64
+
+Example:
+```
+zsh-5.7.1-1-x86_64.pkg.tar.xz
+```
+
+2) Extract the content to your git bash installation dir:
+Usually `C:\Program Files\Git`
+
+3) Test it, open git bash and type:
+```
+zsh
+```
+
+4) If it start the zsh, it is working fine.
+
+`On some cases, there are a stranger characteres on the cmd line.
+It will get fix when installing the oh-my-zsh`
+
+5) Installing oh-my-zsh, execute the following cmd on git bash
+```shell
+sh -c "$(curl -fsSL https://raw.githubusercontent.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"
+```
+
+6) Configuring zsh as default shell
+Edit the `~/.bashrc` file.
+
+Add the following lines at the end of the file
+
+```
+# Launch Zsh
+if [ -t 1 ]; then
+exec zsh
+fi
+```
+
+## optional steps
+
+7) Installing the Honukay theme
+```shell
+curl -fsSL https://raw.githubusercontent.com/oskarkrawczyk/honukai-iterm/master/honukai.zsh-theme -o ~/.oh-my-zsh/custom/themes/honukai.zsh-theme
+```
+
+8) Set it
+```shell
+sed -i 's/ZSH_THEME="robbyrussell"/ZSH_THEME="honukai"/g' ~/.zshrc
+```