...

README.md

@@ -9,6 +9,9 @@ Asimov is our code name for this work untill we get better name and feedback of
 
 ```bash
 hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/script3
+
+# in case you want to open the generated book and edit
+hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/script3 -e
 ```
 
 ## First install hero:
@@ -16,12 +19,28 @@ hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/script
 ```bash
 curl https://raw.githubusercontent.com/freeflowuniverse/crystallib/development/scripts/installer_hero.sh > /tmp/hero_install.sh
 bash /tmp/hero_install.sh
-#to debug
-bash -x /tmp/hero_install.sh
-#maybe you want to copy to your system bin dir
-cp ~/hero/bin/hero /usr/local/bin
 #to use hero make sure you restart your shell or you do (if osx)
 source ~/.zprofile 
 #check how to use, can also do on each of the subcommands
 hero -help
 ```
+
+## troubleshoot
+
+if you see the following, it means you have an outdated brew on your laptop
+
+```bash
+## stderr:
+Error: Cannot install under Rosetta 2 in ARM default prefix (/opt/homebrew)!
+```
+
+to fix:
+
+```bash
+#uninstall
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
+rm -rf /opt/homebrew
+#re-install homebrew
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+```
+