diff --git a/README.md b/README.md
index 1d1b7eb..0a9efbc 100644
--- a/README.md
+++ b/README.md
@@ -1,15 +1,17 @@
-# info for our new Internet / Social network
+# Info for our new Internet / Social network
 
 > [https://info.ourworld.tf/duniayetu](https://info.ourworld.tf/duniayetu)
 
 ## First install hero:
 
 ```bash
+# Download the hero installer script
 curl https://raw.githubusercontent.com/freeflowuniverse/crystallib/development/scripts/installer_hero.sh > /tmp/hero_install.sh
+# Run the script as root to properly complete the script (e.g. sudo bash ...)
 bash /tmp/hero_install.sh
-#check how to use, can also do on each of the subcommands
+# Check how to use, can also do on each of the subcommands
 hero -help
-#if it can't find hero, do the following on osx
+# If it can't find hero, do the following on osx
 source ~/.zprofile 
 ```
 
@@ -20,7 +22,7 @@ source ~/.zprofile
 ```bash
 hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript
 
-# in case you want to open the generated book and edit
+# In case you want to open the generated book and edit
 hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript -e
 ```