Merge branch 'development' into patch-3

1 files changed, 25 insertions, 14 deletions

diff --git a/README.md b/README.md
index d0d7169f..dd347e28 100644
--- a/README.md
+++ b/README.md
@@ -62,8 +62,8 @@ https://github.com/user-attachments/assets/49bc12b2-abaf-45de-a21c-67aacd9bb872
 sh <(curl -L https://raw.githubusercontent.com/JaKooLit/Hyprland-Dots/main/Distro-Hyprland.sh)
 ```
 
-- you can now use above command to automatically clone the Distro-Hyprland install scripts below
-- it will clone the install scripts and start the `install.sh` 😎
+- You can use the above command to automatically clone the `Distro-Hyprland` install scripts
+- It will clone the install script and start the `install.sh` 😎
 
 ### 👁️‍🗨️ My Hyprland install Scripts 👁️‍🗨️
 
@@ -88,8 +88,8 @@ sh <(curl -L https://raw.githubusercontent.com/JaKooLit/Hyprland-Dots/main/Distr
 
 ### 🪧 Attention 🪧
 
-- This repo does NOT contain or will NOT install any packages. These are only pre-configured-hyprland configs or dotfiles
-- refer to install scripts what packages needed to install... but atleast, Hyprland packages is needed 😏😏😏 duh!!
+- This repo does not install any packages. This repo only contains pre-configured-hyprland configs aka `dotfiles`
+- Refer to the install scripts for what packages needed to install. At mimimum, the Hyprland packages are needed 😏😏😏 duh!!
 - This repo will be pulled by the Distro-Hyprland install scripts above if you opt to download pre-configured dots
 
 ### 👀 Screenshots 👀
@@ -101,16 +101,23 @@ sh <(curl -L https://raw.githubusercontent.com/JaKooLit/Hyprland-Dots/main/Distr
 - To easily track changes, I will be updating the [CHANGELOGS](https://github.com/JaKooLit/Hyprland-Dots/wiki/Changelogs) Screenshots will be included if worth mentioning the changes!
 
 > [!NOTE]
-> Kindly note that by defeault, Kools Dots are adjusted / configured for 2k (1440p) display without scaling.
+> Kindly note that by default, Kools Dots are adjusted / configured for 2k (1440p) display without scaling.
 
 ### 💥 Copying / Installation / Update instructions 💥
 
 - [`MORE INFO HERE`](https://github.com/JaKooLit/Hyprland-Dots/wiki/Install_&_Update)
   > [!Note]
-  > The auto copy script "copy.sh" will create backups of intended directories to be copied. However, still a good idea to manually backup just incase script failed to backup!
-- clone this repo by using git. Change directory, make executable and run the script
+  > The auto copy script `copy.sh` will create backups of intended directories to be copied. 
+  > However, it's still a good idea to manually backup just incase script fails to backup your configuration. 
+  > If you already have a hyprland configuration, uninstall it first, or create a new user, and install it with that user
+  
+- Clone this repo by using `git`. 
+- Change directory, i.e. `cd Arch-Hyprland`  
+- Make `install.sh` executable  `chmod +x ./install.sh` 
+- Run the script `./install.sh` 
 
-> to download from Master branch
+> To download from Master branch
+> Note: Ubuntu is exception, it has version specific branches
 
 ```bash
 git clone --depth=1 https://github.com/JaKooLit/Hyprland-Dots.git
@@ -118,7 +125,8 @@ cd Hyprland-Dots
 ```
 
 > to download from Development branch (development and testing)
-> Not recommeded for non-testing systems 
+> Not recommeded for non-testing systems!! 
+> REALLY, not recommended. 
 
 ```bash
 git clone --depth=1 https://github.com/JaKooLit/Hyprland-Dots.git -b development
@@ -162,9 +170,9 @@ chmod +x upgrade.sh
 #### ⚠️⚠️⚠️ ATTENTION - BACKUPS CREATED by SCRIPT
 
 > [!CAUTION]
-> copy.sh, release.sh and even upgrade.sh creates a backup!
-> Kindly investigate manually contents on your $HOME/.config
-> Delete manually all the backups which you dont need
+> `copy.sh`, `release.sh` and even `upgrade.sh` creates a backup!
+> Kindly investigate manually contents on your `$HOME/.config`
+> Delete manually any backups which you dont want.
 
 #### 🛎️ a small note on wallpapers
 
@@ -172,7 +180,8 @@ chmod +x upgrade.sh
 
 #### ⚠️⚠️⚠️ A MUST! after copying / Installing these dots
 
-- Press SUPER W and set a wallpaper. This is also to initiate wallust for waybar, kitty (tty) and rofi themes. However, If you use the copy.sh or the release.sh, there will be a preset initial Wallpaper and you dont have to do this
+- Press `SUPER W` and set a wallpaper. This is also to initiate wallust for waybar, kitty (tty) and rofi themes.
+- However, If you use the `copy.sh` or the `release.sh`, there will be a preset initial Wallpaper and you dont have to do this
 
 - Nvidia Owners. Make sure to edit your `~/.config/hypr/UserConfigs/ENVariables.conf` (highly recommended).
 
@@ -197,11 +206,13 @@ chmod +x upgrade.sh
 
 #### 🙏 Special request
 
-- If you have improvements on the dotfiles or configuration, feel free to submit a PR for improvement. I always welcome improvements as I am also just learning just like you guys!
+- If you have improvements on the dotfiles or configuration, feel free to submit a PR for improvement.
+- I always welcome improvements as I am also just learning just like you guys!
 
 #### ✍️ Contributing
 
 - Want to contribute? Click [`HERE`](https://github.com/JaKooLit/Hyprland-Dots/blob/main/CONTRIBUTING.md) for a guide how to contribute
+>  Thanks to all who have contributed code, or support on the Discord server. You efforts are greatly appreciated 
 
 #### 🤷‍♂️ TO DO!