From 3439077dac2947f1537c00dd1d31b421ac8dac6d Mon Sep 17 00:00:00 2001
From: sasha-astiadi <sasha.astiadi@code.berlin>
Date: Tue, 13 Feb 2024 14:31:11 +0300
Subject: [PATCH 01/15] add missing files / fix

---
 collections/dy_intro/learn.md                    | 0
 collections/problems/problems.md                 | 0
 collections/solutions/cloud/cloud.md             | 0
 collections/solutions/solutions.md               | 0
 collections/values/poa.md                        | 0
 collections/values/values.md                     | 1 +
 collections/why/countries_no_internet.md         | 1 +
 collections/why/current_cloud_too_centralized.md | 1 +
 8 files changed, 3 insertions(+)
 create mode 100644 collections/dy_intro/learn.md
 create mode 100644 collections/problems/problems.md
 create mode 100644 collections/solutions/cloud/cloud.md
 create mode 100644 collections/solutions/solutions.md
 create mode 100644 collections/values/poa.md
 create mode 100644 collections/values/values.md
 create mode 100644 collections/why/countries_no_internet.md
 create mode 100644 collections/why/current_cloud_too_centralized.md

diff --git a/collections/dy_intro/learn.md b/collections/dy_intro/learn.md
new file mode 100644
index 0000000..e69de29
diff --git a/collections/problems/problems.md b/collections/problems/problems.md
new file mode 100644
index 0000000..e69de29
diff --git a/collections/solutions/cloud/cloud.md b/collections/solutions/cloud/cloud.md
new file mode 100644
index 0000000..e69de29
diff --git a/collections/solutions/solutions.md b/collections/solutions/solutions.md
new file mode 100644
index 0000000..e69de29
diff --git a/collections/values/poa.md b/collections/values/poa.md
new file mode 100644
index 0000000..e69de29
diff --git a/collections/values/values.md b/collections/values/values.md
new file mode 100644
index 0000000..f9c8866
--- /dev/null
+++ b/collections/values/values.md
@@ -0,0 +1 @@
+# Our Values
\ No newline at end of file
diff --git a/collections/why/countries_no_internet.md b/collections/why/countries_no_internet.md
new file mode 100644
index 0000000..c4a318f
--- /dev/null
+++ b/collections/why/countries_no_internet.md
@@ -0,0 +1 @@
+# countries_no_internet
\ No newline at end of file
diff --git a/collections/why/current_cloud_too_centralized.md b/collections/why/current_cloud_too_centralized.md
new file mode 100644
index 0000000..c20076d
--- /dev/null
+++ b/collections/why/current_cloud_too_centralized.md
@@ -0,0 +1 @@
+# current_cloud_too_centralized
\ No newline at end of file

From 9dee08117879639c6dd9b0768ad7e7b8131a1b99 Mon Sep 17 00:00:00 2001
From: sasha-astiadi <sasha.astiadi@code.berlin>
Date: Tue, 13 Feb 2024 14:31:34 +0300
Subject: [PATCH 02/15] move file to the right dir

---
 .../painkiller/cd_issues_cloud_not_enough.md}                     | 0
 .../content_providers => problems/painkiller}/cd_issues_cost.md   | 0
 2 files changed, 0 insertions(+), 0 deletions(-)
 rename collections/{solutions/content_providers/cnd_issues_cloud_not_enough.md => problems/painkiller/cd_issues_cloud_not_enough.md} (100%)
 rename collections/{solutions/content_providers => problems/painkiller}/cd_issues_cost.md (100%)

diff --git a/collections/solutions/content_providers/cnd_issues_cloud_not_enough.md b/collections/problems/painkiller/cd_issues_cloud_not_enough.md
similarity index 100%
rename from collections/solutions/content_providers/cnd_issues_cloud_not_enough.md
rename to collections/problems/painkiller/cd_issues_cloud_not_enough.md
diff --git a/collections/solutions/content_providers/cd_issues_cost.md b/collections/problems/painkiller/cd_issues_cost.md
similarity index 100%
rename from collections/solutions/content_providers/cd_issues_cost.md
rename to collections/problems/painkiller/cd_issues_cost.md

From 7fb111734e76b53f7752a16a921dad2235e13a66 Mon Sep 17 00:00:00 2001
From: sasha-astiadi <sasha.astiadi@code.berlin>
Date: Tue, 13 Feb 2024 14:31:49 +0300
Subject: [PATCH 03/15] fix summary error

---
 books/duniayetu_dar/SUMMARY.md | 38 +++++++++++++++++++---------------
 1 file changed, 21 insertions(+), 17 deletions(-)

diff --git a/books/duniayetu_dar/SUMMARY.md b/books/duniayetu_dar/SUMMARY.md
index 98bb2b0..a1d7853 100644
--- a/books/duniayetu_dar/SUMMARY.md
+++ b/books/duniayetu_dar/SUMMARY.md
@@ -6,16 +6,28 @@
   - [Social Warming](why/social_warming.md)
 - [Farming](farming/farming.md)
     - [3Nodes](farming/3nodes.md)
-- [Vision](priciples/planet_people_first.md)
-    - [Proof of Authenticity](priciples/poa.md)
-- [Solutions](tfgrid_structure/solutions.md)
-  - [Decentralized Cloud](solutions/cloud.md)
-  - [Content Providing](solutions/content_providers.md)
+- [Vision](values/values.md)
+    - [Planet and People First](values/planet_people_first.md)
+    - [Proof of Authenticity](values/poa.md)
+- [Problems](problems/problems.md)
       - [painkillers and onions](problems/no_pain_killer.md)
-      - [clouds are complicated](problems/internet_infra/cloud_issues.md)
-      - [content delivery is expensive](problems/internet_infra/cdn_issues.md)
+      - [Clouds are C   omplicated](problems/cd_issues_cloud_not_enough.md)
+      - [Content Delivery is Expensive](problems/cd_issues_cost.md)
+- [Solutions](solutions/solutions.md)
+  - [Decentralized Cloud](solutions/cloud/cloud.md)
+  - [Content Providers](solutions/content_providers/content_providers.md)
       <!-- - [Social Media Platform]() -->
-  - [Web4](solutions/web4.md)
+  - [Web4](WEB4/web4.md)
+- [FreeFlow Movement](freeflow/freeflow_movement.md)
+     - [Community Principles](freeflow/community_principles/community_principles.md)
+- [Social Media Protocols](social_media_protocols/protocols.md)
+     - [Nostr Protocol](social_media_protocols/nostr.md)
+     - [Activity Pub](social_media_protocols/activitypub.md)
+     - [Activity Pub 2](social_media_protocols/activitypub2.md)
+- [Technology](web4/web4.md)
+     - [FreeFlow Self](web4/freeflowself/freeflowself.md)
+     - [Actor Based Development](web4/actor_based/actor_based_approach.md)
+     -  [Vlang](web4/vlang/vlang.md)
 - [Dunia Yetu](dy_intro/dunia_yetu/dunia_yetu.md)
     - [About Us](dy_intro/dunia_yetu/about_us.md)
     - [Our Core Values](dy_intro/dunia_yetu/our_core_values.md)
@@ -28,15 +40,7 @@
         - [Build on top of Tanzania's decentralised Internet](dy_intro/how_you_can_participate/build.md)
         - [Join Our Coding Academy](dy_intro/how_you_can_participate/coding_participate.md)
         - [Join Our Community](dy_intro/how_you_can_participate/community_participate.md)
-- [FreeFlow Movement](freeflow_movement/freeflow_movement.md)
-    - [Community Principles](freeflow_movement/community_principles/community_principles.md)
-    - [Social Media Protocols](social_media_protocols/protocols.md)
-        - [Nostr Protocol](social_media_protocols/nostr.md)
-        - [Activity Pub](social_media_protocols/activitypub.md)
-        - [Activity Pub 2](social_media_protocols/activitypub2.md)
-    - [Technology](ffself_specs/tech.md)
-        - [Actor Based Development](ffself_specs/actor_based/actor_based_approach.md)
-        - [Vlang](ffself_specs/vlang/vlang.md)
+
 
 
 <!-- - [FreeFlow Self](ffself_specs/freeflowself/freeflowself.md) -->

From eb9aa2df90a11f396e384778d9c68fe080117575 Mon Sep 17 00:00:00 2001
From: sasha-astiadi <sasha.astiadi@code.berlin>
Date: Tue, 13 Feb 2024 14:32:02 +0300
Subject: [PATCH 04/15] add missing file

---
 .../social_media_protocols/activitypub2.md       |   0
 collections/values/planet_people_first.md        |   5 +++--
 collections/web4/vlang/img/vlang.png             | Bin 0 -> 6953 bytes
 3 files changed, 3 insertions(+), 2 deletions(-)
 create mode 100644 collections/social_media_protocols/activitypub2.md
 create mode 100644 collections/web4/vlang/img/vlang.png

diff --git a/collections/social_media_protocols/activitypub2.md b/collections/social_media_protocols/activitypub2.md
new file mode 100644
index 0000000..e69de29
diff --git a/collections/values/planet_people_first.md b/collections/values/planet_people_first.md
index dba8170..90bf3f8 100644
--- a/collections/values/planet_people_first.md
+++ b/collections/values/planet_people_first.md
@@ -1,3 +1,5 @@
+# planet_people_first.md
+
 ![](img/planet_first.png)
 
 ## Core Values
@@ -15,5 +17,4 @@
 ## Simplicity
 
 
-> TODO: values, do it in the 2 layers
-
+> TODO: values, do it in the 2 layers
\ No newline at end of file
diff --git a/collections/web4/vlang/img/vlang.png b/collections/web4/vlang/img/vlang.png
new file mode 100644
index 0000000000000000000000000000000000000000..e5543cde493a7f9e0174114839d98bbb2866d012
GIT binary patch
literal 6953
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

literal 0
HcmV?d00001


From 3eddb2bc6ae665b03ae07b036f066589babdd72d Mon Sep 17 00:00:00 2001
From: sasha-astiadi <sasha.astiadi@code.berlin>
Date: Wed, 14 Feb 2024 14:59:48 +0300
Subject: [PATCH 05/15] test

---
 books/duniayetu_dar/SUMMARY.md     | 2 ++
 collections/sasha/ilovezanzibar.md | 9 +++++++++
 2 files changed, 11 insertions(+)
 create mode 100644 collections/sasha/ilovezanzibar.md

diff --git a/books/duniayetu_dar/SUMMARY.md b/books/duniayetu_dar/SUMMARY.md
index a1d7853..bb1b8a8 100644
--- a/books/duniayetu_dar/SUMMARY.md
+++ b/books/duniayetu_dar/SUMMARY.md
@@ -29,6 +29,7 @@
      - [Actor Based Development](web4/actor_based/actor_based_approach.md)
      -  [Vlang](web4/vlang/vlang.md)
 - [Dunia Yetu](dy_intro/dunia_yetu/dunia_yetu.md)
+
     - [About Us](dy_intro/dunia_yetu/about_us.md)
     - [Our Core Values](dy_intro/dunia_yetu/our_core_values.md)
     - [What We Offer](dy_intro/what_we_offer/what_we_offer.md)
@@ -40,6 +41,7 @@
         - [Build on top of Tanzania's decentralised Internet](dy_intro/how_you_can_participate/build.md)
         - [Join Our Coding Academy](dy_intro/how_you_can_participate/coding_participate.md)
         - [Join Our Community](dy_intro/how_you_can_participate/community_participate.md)
+    - [SASHA sidebar](sasha/ilovezanzibar.md)
 
 
 
diff --git a/collections/sasha/ilovezanzibar.md b/collections/sasha/ilovezanzibar.md
new file mode 100644
index 0000000..dcfd175
--- /dev/null
+++ b/collections/sasha/ilovezanzibar.md
@@ -0,0 +1,9 @@
+# HEEEY WHATS UP 
+
+JUSt testing. 
+
+stay awesome.
+
+live 
+laugh
+love
\ No newline at end of file

From 7603272a345ae78ef496a4a9866a307ce7b99cba Mon Sep 17 00:00:00 2001
From: sasha-astiadi <sasha.astiadi@code.berlin>
Date: Wed, 14 Feb 2024 15:00:17 +0300
Subject: [PATCH 06/15] edit

---
 books/duniayetu_dar/SUMMARY.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/books/duniayetu_dar/SUMMARY.md b/books/duniayetu_dar/SUMMARY.md
index bb1b8a8..6068a4d 100644
--- a/books/duniayetu_dar/SUMMARY.md
+++ b/books/duniayetu_dar/SUMMARY.md
@@ -41,7 +41,7 @@
         - [Build on top of Tanzania's decentralised Internet](dy_intro/how_you_can_participate/build.md)
         - [Join Our Coding Academy](dy_intro/how_you_can_participate/coding_participate.md)
         - [Join Our Community](dy_intro/how_you_can_participate/community_participate.md)
-    - [SASHA sidebar](sasha/ilovezanzibar.md)
+- [SASHA sidebar](sasha/ilovezanzibar.md)
 
 
 

From 3121c2e123a5ce305e5739bf7866e118a1957f8d Mon Sep 17 00:00:00 2001
From: Mik Perreault <perreault@incubaid.com>
Date: Wed, 14 Feb 2024 16:24:39 +0000
Subject: [PATCH 07/15] Update README.md

Added that root is needed to properly set the path when running the script.
---
 README.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

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
 ```
 

From 9391ea20abe6de6c51f53212e6080e25826d5de8 Mon Sep 17 00:00:00 2001
From: pcone <logismos@protonmail.ch>
Date: Wed, 14 Feb 2024 18:47:55 -0500
Subject: [PATCH 08/15] added docs/fullvm guide

---
 README.md                  |   1 +
 docs/hero_mdbook_fullvm.md | 122 +++++++++++++++++++++++++++++++++++++
 2 files changed, 123 insertions(+)
 create mode 100644 docs/hero_mdbook_fullvm.md

diff --git a/README.md b/README.md
index 0a9efbc..864aa2f 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,7 @@ hero -help
 source ~/.zprofile 
 ```
 
+There is also a quick guide on setting mdbook and hero on a full VM running on the TFGrid. Read the [docs](./docs/hero_mdbook_fullvm.md) for more information.
 
 ## to run the book
 
diff --git a/docs/hero_mdbook_fullvm.md b/docs/hero_mdbook_fullvm.md
new file mode 100644
index 0000000..a1c1b95
--- /dev/null
+++ b/docs/hero_mdbook_fullvm.md
@@ -0,0 +1,122 @@
+<h1>Hero and mdbook<h1>
+
+<h2>Table of Contents</h2>
+
+- [Introduction](#introduction)
+- [Prerequisites](#prerequisites)
+- [Setting the Full VM](#setting-the-full-vm)
+  - [Install cargo](#install-cargo)
+  - [Install redis](#install-redis)
+- [Install pkg-config, gcc and libssl](#install-pkg-config-gcc-and-libssl)
+- [Set Hero](#set-hero)
+- [Generate the mdbook](#generate-the-mdbook)
+  - [Access the mdbook from your local machine with the SSH tunnel](#access-the-mdbook-from-your-local-machine-with-the-ssh-tunnel)
+
+***
+
+## Introduction
+
+We show how to work with mdbook using the [hero](https://github.com/freeflowuniverse/crystallib/tree/development/cli/hero) tool.
+
+For this guide, we show an example using the mdbook from the repository [info_tfgrid](https://git.ourworld.tf/tfgrid/info_tfgrid).
+
+This guide can be done locally or on a VM. It should be run as root. We show the steps for a full VM deployed on the TFGrid with WireGuard.
+
+## Prerequisites
+
+On the full VM, you will need to install the following:
+
+- cargo
+- redis
+- gcc
+- pkg-config
+- libssl-dev
+
+Steps will be show to install those prerequisites.
+
+## Setting the Full VM
+
+- Deploy a full VM with WireGuard on the TFGrid
+- Connect to the full VM with an SSH tunnel on port 3333 on both local and VM
+    ```
+    ssh -4 -L 3333:127.0.0.1:3333 root@10.20.4.2
+    ```
+- Preprare the VM:
+    ```
+    apt update && apt upgrade -y
+    ```
+
+### Install cargo
+
+Once you install cargo, all mdbook dependencies will be installed via the hero script.
+
+- Install cargo rust for linux and mac (with default installation)
+    ```
+    curl https://sh.rustup.rs -sSf | sh
+    ```
+- Configure the current shell
+    ```
+    source "$HOME/.cargo/env"
+    ```
+
+### Install redis
+
+- Install redis on the VM
+    ```
+    apt install lsb-release curl gpg
+    curl -fsSL https://packages.redis.io/gpg | gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
+    echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | tee /etc/apt/sources.list.d/redis.list
+    apt-get update
+    apt-get install redis -y
+    ```
+
+## Install pkg-config, gcc and libssl
+
+- Install other packages
+    ```
+    apt install pkg-config -y
+    apt-get install gcc -y
+    apt install libssl-dev
+    ```
+
+## Set Hero
+
+- Download the hero installation script
+    ```
+    curl https://raw.githubusercontent.com/freeflowuniverse/crystallib/development/scripts/installer_hero.sh > /tmp/hero_install.sh
+    ```
+- Run the script as root
+    ```
+    bash /tmp/hero_install.sh
+    ```
+- Run hero to confirm the installation is done properly
+    ```
+    hero -help
+    ```
+
+## Generate the mdbook
+
+- Start the ssh-agent
+    ```
+    eval $(ssh-agent) # start the ssh-agent
+    ```
+- Generate the mdbook with hero
+    ```
+    hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript
+    ```
+- Change directory to where the book is built
+    ```
+    cd /root/hero/var/mdbuild/book_name
+    ```
+- You can then edit the content of the book as with any mdbook
+    ```
+    mdbook build
+    ```
+
+### Access the mdbook from your local machine with the SSH tunnel
+
+- To serve on your local machine, make sure to use the same part as the one set in your SSH tunnel (here it's port 3333)
+    ```
+    mdbook serve --port 3333 
+    ```
+- To see the mdbook live, open a browser on the local machine and go to localhost:3333
\ No newline at end of file

From 904168926cabc06ae54070e4eac6098fc5bd0478 Mon Sep 17 00:00:00 2001
From: pcone <logismos@protonmail.ch>
Date: Wed, 14 Feb 2024 18:50:59 -0500
Subject: [PATCH 09/15] adjusted details

---
 docs/hero_mdbook_fullvm.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/hero_mdbook_fullvm.md b/docs/hero_mdbook_fullvm.md
index a1c1b95..c6b2cc4 100644
--- a/docs/hero_mdbook_fullvm.md
+++ b/docs/hero_mdbook_fullvm.md
@@ -1,4 +1,4 @@
-<h1>Hero and mdbook<h1>
+<h1>Hero and mdbook on a Full VM</h1>
 
 <h2>Table of Contents</h2>
 
@@ -7,10 +7,10 @@
 - [Setting the Full VM](#setting-the-full-vm)
   - [Install cargo](#install-cargo)
   - [Install redis](#install-redis)
-- [Install pkg-config, gcc and libssl](#install-pkg-config-gcc-and-libssl)
+  - [Install pkg-config, gcc and libssl](#install-pkg-config-gcc-and-libssl)
 - [Set Hero](#set-hero)
 - [Generate the mdbook](#generate-the-mdbook)
-  - [Access the mdbook from your local machine with the SSH tunnel](#access-the-mdbook-from-your-local-machine-with-the-ssh-tunnel)
+- [Access the mdbook from your local machine with the SSH tunnel](#access-the-mdbook-from-your-local-machine-with-the-ssh-tunnel)
 
 ***
 
@@ -32,7 +32,7 @@ On the full VM, you will need to install the following:
 - pkg-config
 - libssl-dev
 
-Steps will be show to install those prerequisites.
+Steps will be shown to install those prerequisites.
 
 ## Setting the Full VM
 
@@ -70,7 +70,7 @@ Once you install cargo, all mdbook dependencies will be installed via the hero s
     apt-get install redis -y
     ```
 
-## Install pkg-config, gcc and libssl
+### Install pkg-config, gcc and libssl
 
 - Install other packages
     ```
@@ -113,7 +113,7 @@ Once you install cargo, all mdbook dependencies will be installed via the hero s
     mdbook build
     ```
 
-### Access the mdbook from your local machine with the SSH tunnel
+## Access the mdbook from your local machine with the SSH tunnel
 
 - To serve on your local machine, make sure to use the same part as the one set in your SSH tunnel (here it's port 3333)
     ```

From 2bc550f806043f54e7c1888345e65e1de4a939f9 Mon Sep 17 00:00:00 2001
From: mik-tf <perreault@incubaid.com>
Date: Thu, 15 Feb 2024 00:38:42 +0000
Subject: [PATCH 10/15] Update docs/hero_mdbook_fullvm.md

removed duplicate string
---
 docs/hero_mdbook_fullvm.md | 242 ++++++++++++++++++-------------------
 1 file changed, 121 insertions(+), 121 deletions(-)

diff --git a/docs/hero_mdbook_fullvm.md b/docs/hero_mdbook_fullvm.md
index c6b2cc4..04b8a04 100644
--- a/docs/hero_mdbook_fullvm.md
+++ b/docs/hero_mdbook_fullvm.md
@@ -1,122 +1,122 @@
-<h1>Hero and mdbook on a Full VM</h1>
-
-<h2>Table of Contents</h2>
-
-- [Introduction](#introduction)
-- [Prerequisites](#prerequisites)
-- [Setting the Full VM](#setting-the-full-vm)
-  - [Install cargo](#install-cargo)
-  - [Install redis](#install-redis)
-  - [Install pkg-config, gcc and libssl](#install-pkg-config-gcc-and-libssl)
-- [Set Hero](#set-hero)
-- [Generate the mdbook](#generate-the-mdbook)
-- [Access the mdbook from your local machine with the SSH tunnel](#access-the-mdbook-from-your-local-machine-with-the-ssh-tunnel)
-
-***
-
-## Introduction
-
-We show how to work with mdbook using the [hero](https://github.com/freeflowuniverse/crystallib/tree/development/cli/hero) tool.
-
-For this guide, we show an example using the mdbook from the repository [info_tfgrid](https://git.ourworld.tf/tfgrid/info_tfgrid).
-
-This guide can be done locally or on a VM. It should be run as root. We show the steps for a full VM deployed on the TFGrid with WireGuard.
-
-## Prerequisites
-
-On the full VM, you will need to install the following:
-
-- cargo
-- redis
-- gcc
-- pkg-config
-- libssl-dev
-
-Steps will be shown to install those prerequisites.
-
-## Setting the Full VM
-
-- Deploy a full VM with WireGuard on the TFGrid
-- Connect to the full VM with an SSH tunnel on port 3333 on both local and VM
-    ```
-    ssh -4 -L 3333:127.0.0.1:3333 root@10.20.4.2
-    ```
-- Preprare the VM:
-    ```
-    apt update && apt upgrade -y
-    ```
-
-### Install cargo
-
-Once you install cargo, all mdbook dependencies will be installed via the hero script.
-
-- Install cargo rust for linux and mac (with default installation)
-    ```
-    curl https://sh.rustup.rs -sSf | sh
-    ```
-- Configure the current shell
-    ```
-    source "$HOME/.cargo/env"
-    ```
-
-### Install redis
-
-- Install redis on the VM
-    ```
-    apt install lsb-release curl gpg
-    curl -fsSL https://packages.redis.io/gpg | gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
-    echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | tee /etc/apt/sources.list.d/redis.list
-    apt-get update
-    apt-get install redis -y
-    ```
-
-### Install pkg-config, gcc and libssl
-
-- Install other packages
-    ```
-    apt install pkg-config -y
-    apt-get install gcc -y
-    apt install libssl-dev
-    ```
-
-## Set Hero
-
-- Download the hero installation script
-    ```
-    curl https://raw.githubusercontent.com/freeflowuniverse/crystallib/development/scripts/installer_hero.sh > /tmp/hero_install.sh
-    ```
-- Run the script as root
-    ```
-    bash /tmp/hero_install.sh
-    ```
-- Run hero to confirm the installation is done properly
-    ```
-    hero -help
-    ```
-
-## Generate the mdbook
-
-- Start the ssh-agent
-    ```
-    eval $(ssh-agent) # start the ssh-agent
-    ```
-- Generate the mdbook with hero
-    ```
-    hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript
-    ```
-- Change directory to where the book is built
-    ```
-    cd /root/hero/var/mdbuild/book_name
-    ```
-- You can then edit the content of the book as with any mdbook
-    ```
-    mdbook build
-    ```
-
-## Access the mdbook from your local machine with the SSH tunnel
-
-- To serve on your local machine, make sure to use the same part as the one set in your SSH tunnel (here it's port 3333)
-    ```
-    mdbook serve --port 3333 
-    ```
+<h1>Hero and mdbook on a Full VM</h1>
+
+<h2>Table of Contents</h2>
+
+- [Introduction](#introduction)
+- [Prerequisites](#prerequisites)
+- [Setting the Full VM](#setting-the-full-vm)
+  - [Install cargo](#install-cargo)
+  - [Install redis](#install-redis)
+  - [Install pkg-config, gcc and libssl](#install-pkg-config-gcc-and-libssl)
+- [Set Hero](#set-hero)
+- [Generate the mdbook](#generate-the-mdbook)
+- [Access the mdbook from your local machine with the SSH tunnel](#access-the-mdbook-from-your-local-machine-with-the-ssh-tunnel)
+
+***
+
+## Introduction
+
+We show how to work with mdbook using the [hero](https://github.com/freeflowuniverse/crystallib/tree/development/cli/hero) tool.
+
+For this guide, we show an example using the mdbook from the repository [info_tfgrid](https://git.ourworld.tf/tfgrid/info_tfgrid).
+
+This guide can be done locally or on a VM. It should be run as root. We show the steps for a full VM deployed on the TFGrid with WireGuard.
+
+## Prerequisites
+
+On the full VM, you will need to install the following:
+
+- cargo
+- redis
+- gcc
+- pkg-config
+- libssl-dev
+
+Steps will be shown to install those prerequisites.
+
+## Setting the Full VM
+
+- Deploy a full VM with WireGuard on the TFGrid
+- Connect to the full VM with an SSH tunnel on port 3333 on both local and VM
+    ```
+    ssh -4 -L 3333:127.0.0.1:3333 root@10.20.4.2
+    ```
+- Preprare the VM:
+    ```
+    apt update && apt upgrade -y
+    ```
+
+### Install cargo
+
+Once you install cargo, all mdbook dependencies will be installed via the hero script.
+
+- Install cargo rust for linux and mac (with default installation)
+    ```
+    curl https://sh.rustup.rs -sSf | sh
+    ```
+- Configure the current shell
+    ```
+    source "$HOME/.cargo/env"
+    ```
+
+### Install redis
+
+- Install redis on the VM
+    ```
+    apt install lsb-release curl gpg
+    curl -fsSL https://packages.redis.io/gpg | gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
+    echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | tee /etc/apt/sources.list.d/redis.list
+    apt-get update
+    apt-get install redis -y
+    ```
+
+### Install pkg-config, gcc and libssl
+
+- Install other packages
+    ```
+    apt install pkg-config -y
+    apt-get install gcc -y
+    apt install libssl-dev
+    ```
+
+## Set Hero
+
+- Download the hero installation script
+    ```
+    curl https://raw.githubusercontent.com/freeflowuniverse/crystallib/development/scripts/installer_hero.sh > /tmp/hero_install.sh
+    ```
+- Run the script as root
+    ```
+    bash /tmp/hero_install.sh
+    ```
+- Run hero to confirm the installation is done properly
+    ```
+    hero -help
+    ```
+
+## Generate the mdbook
+
+- Start the ssh-agent
+    ```
+    eval $(ssh-agent)
+    ```
+- Generate the mdbook with hero
+    ```
+    hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript
+    ```
+- Change directory to where the book is built
+    ```
+    cd /root/hero/var/mdbuild/book_name
+    ```
+- You can then edit the content of the book as with any mdbook
+    ```
+    mdbook build
+    ```
+
+## Access the mdbook from your local machine with the SSH tunnel
+
+- To serve on your local machine, make sure to use the same part as the one set in your SSH tunnel (here it's port 3333)
+    ```
+    mdbook serve --port 3333 
+    ```
 - To see the mdbook live, open a browser on the local machine and go to localhost:3333
\ No newline at end of file

From a46201f06bf13b973e1832b1dc26b46bc68474da Mon Sep 17 00:00:00 2001
From: mik-tf <perreault@incubaid.com>
Date: Thu, 15 Feb 2024 15:12:35 +0000
Subject: [PATCH 11/15] Update docs/hero_mdbook_fullvm.md

adjusted typo
---
 docs/hero_mdbook_fullvm.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/hero_mdbook_fullvm.md b/docs/hero_mdbook_fullvm.md
index 04b8a04..5123de2 100644
--- a/docs/hero_mdbook_fullvm.md
+++ b/docs/hero_mdbook_fullvm.md
@@ -41,7 +41,7 @@ Steps will be shown to install those prerequisites.
     ```
     ssh -4 -L 3333:127.0.0.1:3333 root@10.20.4.2
     ```
-- Preprare the VM:
+- Prepare the VM:
     ```
     apt update && apt upgrade -y
     ```

From 87c22f00e18ea78ab90d2b98fbfb5fc1e3df6295 Mon Sep 17 00:00:00 2001
From: pcone <logismos@protonmail.ch>
Date: Thu, 15 Feb 2024 14:55:04 -0500
Subject: [PATCH 12/15] added hero mdbook script

---
 docs/hero_mdbook_fullvm.md        | 53 +++++++++++++--------
 docs/hero_mdbook_fullvm_script.md | 78 +++++++++++++++++++++++++++++++
 scripts/hero_mdbook.sh            | 38 +++++++++++++++
 3 files changed, 150 insertions(+), 19 deletions(-)
 create mode 100644 docs/hero_mdbook_fullvm_script.md
 create mode 100644 scripts/hero_mdbook.sh

diff --git a/docs/hero_mdbook_fullvm.md b/docs/hero_mdbook_fullvm.md
index 5123de2..6a333f6 100644
--- a/docs/hero_mdbook_fullvm.md
+++ b/docs/hero_mdbook_fullvm.md
@@ -3,45 +3,56 @@
 <h2>Table of Contents</h2>
 
 - [Introduction](#introduction)
-- [Prerequisites](#prerequisites)
 - [Setting the Full VM](#setting-the-full-vm)
+  - [Remote Explorer Access](#remote-explorer-access)
   - [Install cargo](#install-cargo)
   - [Install redis](#install-redis)
   - [Install pkg-config, gcc and libssl](#install-pkg-config-gcc-and-libssl)
 - [Set Hero](#set-hero)
 - [Generate the mdbook](#generate-the-mdbook)
-- [Access the mdbook from your local machine with the SSH tunnel](#access-the-mdbook-from-your-local-machine-with-the-ssh-tunnel)
+- [Serve and View the mdbook](#serve-and-view-the-mdbook)
+- [Questions and Feedback](#questions-and-feedback)
 
 ***
 
 ## Introduction
 
-We show how to work with mdbook using the [hero](https://github.com/freeflowuniverse/crystallib/tree/development/cli/hero) tool.
+In this tutorial, we show all the steps to deploy an mdbook with the [hero](https://github.com/freeflowuniverse/crystallib/tree/development/cli/hero) tool. 
 
-For this guide, we show an example using the mdbook from the repository [info_tfgrid](https://git.ourworld.tf/tfgrid/info_tfgrid).
+For this guide, we show an example using the mdbook from the repository [info_tfgrid](https://git.ourworld.tf/tfgrid/info_tfgrid). This setup can be done locally or on a VM. Note that it should be run as root. 
 
-This guide can be done locally or on a VM. It should be run as root. We show the steps for a full VM deployed on the TFGrid with WireGuard.
+We show the steps for a full VM deployed on the TFGrid with WireGuard. We use `10.20.4.2` as a WireGuard IP address. Adjust according to your own setup.
 
-## Prerequisites
+We will be using SSH to connect to the VM and to create an SSH tunnel between the local machine and the VM. This will allow the mdbook output to be displayed on a local browser.
 
-On the full VM, you will need to install the following:
+To manage the mdbook files, we will be using the remote explorer feature of either VSCodium or VSCode.
 
-- cargo
-- redis
-- gcc
-- pkg-config
-- libssl-dev
+## Setting the Full VM 
 
-Steps will be shown to install those prerequisites.
-
-## Setting the Full VM
+We start by deploying a full VM with WireGuard on the TFGrid. We also set an SSH tunnel.
 
 - Deploy a full VM with WireGuard on the TFGrid
-- Connect to the full VM with an SSH tunnel on port 3333 on both local and VM
+- Set an SSH tunnel, on port 3333 for both local and VM
     ```
     ssh -4 -L 3333:127.0.0.1:3333 root@10.20.4.2
     ```
-- Prepare the VM:
+
+Instead of working on the SSH tunnel terminal window, we will be using the remote explorer feature of a source-code editor.
+
+### Remote Explorer Access
+
+You can use the remote explorer feature of both [VSCode](https://marketplace.visualstudio.com/items?itemName=ms-vscode.remote-repositories) and [VSCodium](https://open-vsx.org/extension/jeanp413/open-remote-ssh) to manage the mdbook.
+
+- Open the window `Remote Explorer`, click on `Add New` and write the following in the SSH config file:
+    ```
+    Host 10.20.4.2
+        HostName 10.20.4.2
+        User root
+    ```
+- Click on `Connect to Host`
+- Open the main `/root` directory
+- Right-click on the main window of the directory and select `Open in Integrated Terminal`
+- Update and upgrade the VM
     ```
     apt update && apt upgrade -y
     ```
@@ -113,10 +124,14 @@ Once you install cargo, all mdbook dependencies will be installed via the hero s
     mdbook build
     ```
 
-## Access the mdbook from your local machine with the SSH tunnel
+## Serve and View the mdbook
 
 - To serve on your local machine, make sure to use the same part as the one set in your SSH tunnel (here it's port 3333)
     ```
     mdbook serve --port 3333 
     ```
-- To see the mdbook live, open a browser on the local machine and go to localhost:3333
\ No newline at end of file
+- To see the mdbook live, open a browser on the local machine and go to localhost:3333
+
+## Questions and Feedback
+
+If you have any questions or feedback, please let us know by either writing a post on the [ThreeFold Forum](https://forum.threefold.io/), or by chatting with us on the [TF Grid Tester Community](https://t.me/threefoldtesting) Telegram channel.
\ No newline at end of file
diff --git a/docs/hero_mdbook_fullvm_script.md b/docs/hero_mdbook_fullvm_script.md
new file mode 100644
index 0000000..1b65565
--- /dev/null
+++ b/docs/hero_mdbook_fullvm_script.md
@@ -0,0 +1,78 @@
+<h1>Hero and mdbook on a Full VM: Script</h1>
+
+<h2>Table of Contents</h2>
+
+- [Introduction](#introduction)
+- [Setting the Full VM](#setting-the-full-vm)
+- [Remote Explorer Access](#remote-explorer-access)
+- [Download and Run the Script](#download-and-run-the-script)
+- [Serve and View the mdbook](#serve-and-view-the-mdbook)
+- [Questions and Feedback](#questions-and-feedback)
+
+***
+
+## Introduction
+
+In this tutorial, we show how to use a script to deploy an mdbook with the [hero](https://github.com/freeflowuniverse/crystallib/tree/development/cli/hero) tool. 
+
+For this guide, we show an example using the mdbook from the repository [info_tfgrid](https://git.ourworld.tf/tfgrid/info_tfgrid). This setup can be done locally or on a VM. Note that it should be run as root. 
+
+We show the steps for a full VM deployed on the TFGrid with WireGuard. We use `10.20.4.2` as a WireGuard IP address. Adjust according to your own setup.
+
+We will be using SSH to connect to the VM and to create an SSH tunnel between the local machine and the VM. This will allow the mdbook output to be displayed on a local browser.
+
+To manage the mdbook files, we will be using the remote explorer feature of either VSCodium or VSCode.
+
+## Setting the Full VM 
+
+We start by deploying a full VM with WireGuard on the TFGrid. We also set an SSH tunnel.
+
+- Deploy a full VM with WireGuard on the TFGrid
+- Set an SSH tunnel, on port 3333 for both local and VM
+    ```
+    ssh -4 -L 3333:127.0.0.1:3333 root@10.20.4.2
+    ```
+
+Instead of working on the SSH tunnel terminal window, we will be using the remote explorer feature of a source-code editor.
+
+## Remote Explorer Access
+
+You can use the remote explorer feature of both [VSCode](https://marketplace.visualstudio.com/items?itemName=ms-vscode.remote-repositories) and [VSCodium](https://open-vsx.org/extension/jeanp413/open-remote-ssh) to manage the mdbook.
+
+- Open the window `Remote Explorer`, click on `Add New` and write the following in the SSH config file:
+    ```
+    Host 10.20.4.2
+        HostName 10.20.4.2
+        User root
+    ```
+- Click on `Connect to Host`
+- Open the main `/root` directory
+- Right-click on the main window of the directory and select `Open in Integrated Terminal`
+
+## Download and Run the Script
+
+- Download the script
+    ```
+    wget https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/scripts/hero_mdbook.sh
+    ```
+- Run the script (this will take a couple of minutes)
+    ```
+    source hero_mdbook.sh
+    ```
+
+## Serve and View the mdbook
+
+- Serve the mdbook
+    ```
+    mdbook serve --port 3333
+    ```
+- Open your browser and use the following URL:
+    ```
+    localhost:3333
+    ```
+
+You can now work on the mdbook and see live the changes your bring to the mdbook files on the remote VM.
+
+## Questions and Feedback
+
+If you have any questions or feedback, please let us know by either writing a post on the [ThreeFold Forum](https://forum.threefold.io/), or by chatting with us on the [TF Grid Tester Community](https://t.me/threefoldtesting) Telegram channel.
\ No newline at end of file
diff --git a/scripts/hero_mdbook.sh b/scripts/hero_mdbook.sh
new file mode 100644
index 0000000..3dec9d5
--- /dev/null
+++ b/scripts/hero_mdbook.sh
@@ -0,0 +1,38 @@
+#!/bin/bash
+sed -i "s/#\$nrconf{kernelhints} = -1;/\$nrconf{kernelhints} = -1;/g" /etc/needrestart/needrestart.conf
+sed -i "/#\$nrconf{restart} = 'i';/s/.*/\$nrconf{restart} = 'a';/" /etc/needrestart/needrestart.conf
+apt update && apt upgrade -y
+curl https://sh.rustup.rs -sSf | sh -s -- -y
+source "$HOME/.cargo/env"
+export PATH=$PATH:/root/.cargo/bin
+apt install lsb-release curl gpg
+curl -fsSL https://packages.redis.io/gpg | gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
+echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | tee /etc/apt/sources.list.d/redis.list
+apt-get update
+apt-get install redis -y
+apt install pkg-config -y
+apt-get install gcc -y
+apt install libssl-dev
+curl https://raw.githubusercontent.com/freeflowuniverse/crystallib/development/scripts/installer_hero.sh > /tmp/hero_install.sh
+bash /tmp/hero_install.sh
+eval $(ssh-agent)
+hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript
+cd /root/hero/var/mdbuild/duniayetu
+mdbook build
+cat <<EOF
+
+* * * * *
+
+The script has been successfully completed.
+
+To see the mdbook live on your browser with the SSH tunnel, 
+run the following command with the proper port (here we use 3333).
+
+mdbook serve --port 3333
+
+Happy mdbooking!
+
+* * * * *
+
+EOF
+return 2> /dev/null; exit
\ No newline at end of file

From 1a8f636ef3368cf45551c864c608b75723c20dc7 Mon Sep 17 00:00:00 2001
From: pcone <logismos@protonmail.ch>
Date: Thu, 15 Feb 2024 15:01:14 -0500
Subject: [PATCH 13/15] adjusted wget

---
 docs/hero_mdbook_fullvm_script.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/hero_mdbook_fullvm_script.md b/docs/hero_mdbook_fullvm_script.md
index 1b65565..9385877 100644
--- a/docs/hero_mdbook_fullvm_script.md
+++ b/docs/hero_mdbook_fullvm_script.md
@@ -53,7 +53,7 @@ You can use the remote explorer feature of both [VSCode](https://marketplace.vis
 
 - Download the script
     ```
-    wget https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/scripts/hero_mdbook.sh
+    wget https://git.ourworld.tf/tfgrid/info_tfgrid/raw/branch/main/scripts/hero_mdbook.sh
     ```
 - Run the script (this will take a couple of minutes)
     ```

From 07c9f7f84fa8fbb64925adb28fedc4c8dcdca738 Mon Sep 17 00:00:00 2001
From: pcone <logismos@protonmail.ch>
Date: Thu, 15 Feb 2024 16:49:23 -0500
Subject: [PATCH 14/15] simplified process

---
 docs/hero_mdbook_fullvm.md        | 16 +++---------
 docs/hero_mdbook_fullvm_script.md | 16 +++---------
 scripts/hero_mdbook.sh            | 41 +++++++++++++++++++++++++------
 3 files changed, 41 insertions(+), 32 deletions(-)

diff --git a/docs/hero_mdbook_fullvm.md b/docs/hero_mdbook_fullvm.md
index 6a333f6..afdbf59 100644
--- a/docs/hero_mdbook_fullvm.md
+++ b/docs/hero_mdbook_fullvm.md
@@ -23,21 +23,13 @@ For this guide, we show an example using the mdbook from the repository [info_tf
 
 We show the steps for a full VM deployed on the TFGrid with WireGuard. We use `10.20.4.2` as a WireGuard IP address. Adjust according to your own setup.
 
-We will be using SSH to connect to the VM and to create an SSH tunnel between the local machine and the VM. This will allow the mdbook output to be displayed on a local browser.
-
-To manage the mdbook files, we will be using the remote explorer feature of either VSCodium or VSCode.
+We will be using SSH to connect to the VM and we will access the mdbook output on a local browser. To manage the mdbook files, we will be using the remote explorer feature of either VSCodium or VSCode.
 
 ## Setting the Full VM 
 
-We start by deploying a full VM with WireGuard on the TFGrid. We also set an SSH tunnel.
+We start by deploying a full VM with WireGuard on the TFGrid.
 
-- Deploy a full VM with WireGuard on the TFGrid
-- Set an SSH tunnel, on port 3333 for both local and VM
-    ```
-    ssh -4 -L 3333:127.0.0.1:3333 root@10.20.4.2
-    ```
-
-Instead of working on the SSH tunnel terminal window, we will be using the remote explorer feature of a source-code editor.
+To connect to the VM, we will be using a remote explorer.
 
 ### Remote Explorer Access
 
@@ -128,7 +120,7 @@ Once you install cargo, all mdbook dependencies will be installed via the hero s
 
 - To serve on your local machine, make sure to use the same part as the one set in your SSH tunnel (here it's port 3333)
     ```
-    mdbook serve --port 3333 
+    mdbook serve --hostname 0.0.0.0 --port 3333
     ```
 - To see the mdbook live, open a browser on the local machine and go to localhost:3333
 
diff --git a/docs/hero_mdbook_fullvm_script.md b/docs/hero_mdbook_fullvm_script.md
index 9385877..f3aa86a 100644
--- a/docs/hero_mdbook_fullvm_script.md
+++ b/docs/hero_mdbook_fullvm_script.md
@@ -19,21 +19,13 @@ For this guide, we show an example using the mdbook from the repository [info_tf
 
 We show the steps for a full VM deployed on the TFGrid with WireGuard. We use `10.20.4.2` as a WireGuard IP address. Adjust according to your own setup.
 
-We will be using SSH to connect to the VM and to create an SSH tunnel between the local machine and the VM. This will allow the mdbook output to be displayed on a local browser.
-
-To manage the mdbook files, we will be using the remote explorer feature of either VSCodium or VSCode.
+We will be using SSH to connect to the VM and we will access the mdbook output on a local browser. To manage the mdbook files, we will be using the remote explorer feature of either VSCodium or VSCode.
 
 ## Setting the Full VM 
 
-We start by deploying a full VM with WireGuard on the TFGrid. We also set an SSH tunnel.
+We start by deploying a full VM with WireGuard on the TFGrid. 
 
-- Deploy a full VM with WireGuard on the TFGrid
-- Set an SSH tunnel, on port 3333 for both local and VM
-    ```
-    ssh -4 -L 3333:127.0.0.1:3333 root@10.20.4.2
-    ```
-
-Instead of working on the SSH tunnel terminal window, we will be using the remote explorer feature of a source-code editor.
+To connect to the VM, we will be using a remote explorer.
 
 ## Remote Explorer Access
 
@@ -64,7 +56,7 @@ You can use the remote explorer feature of both [VSCode](https://marketplace.vis
 
 - Serve the mdbook
     ```
-    mdbook serve --port 3333
+    mdbook serve --hostname 0.0.0.0 --port 3333
     ```
 - Open your browser and use the following URL:
     ```
diff --git a/scripts/hero_mdbook.sh b/scripts/hero_mdbook.sh
index 3dec9d5..d94caa1 100644
--- a/scripts/hero_mdbook.sh
+++ b/scripts/hero_mdbook.sh
@@ -1,38 +1,63 @@
 #!/bin/bash
+
+# Generate opening text.
+cat <<EOF
+
+* * * * *
+
+Welcome!
+
+The script will install hero and set the environment to work with mdbook.
+This will take a couple of minutes.
+
+* * * * *
+
+EOF
+
+sleep 2
+
+# Disable "Pending kernel upgrade" and  "Daemons using outdated libraries" windows
 sed -i "s/#\$nrconf{kernelhints} = -1;/\$nrconf{kernelhints} = -1;/g" /etc/needrestart/needrestart.conf
 sed -i "/#\$nrconf{restart} = 'i';/s/.*/\$nrconf{restart} = 'a';/" /etc/needrestart/needrestart.conf
-apt update && apt upgrade -y
+
+# Update and install dependencies
+apt-get update
+apt-get install -y lsb-release gpg
 curl https://sh.rustup.rs -sSf | sh -s -- -y
 source "$HOME/.cargo/env"
 export PATH=$PATH:/root/.cargo/bin
-apt install lsb-release curl gpg
 curl -fsSL https://packages.redis.io/gpg | gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
 echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | tee /etc/apt/sources.list.d/redis.list
 apt-get update
-apt-get install redis -y
-apt install pkg-config -y
-apt-get install gcc -y
-apt install libssl-dev
+apt-get install -y redis pkg-config gcc libssl-dev
+
+# Download and run the hero installer script
 curl https://raw.githubusercontent.com/freeflowuniverse/crystallib/development/scripts/installer_hero.sh > /tmp/hero_install.sh
 bash /tmp/hero_install.sh
+
+# Start the SSH agent, run hero mdbook and build the mdbook
 eval $(ssh-agent)
 hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript
 cd /root/hero/var/mdbuild/duniayetu
 mdbook build
+
+# Generate closing text after successful script.
 cat <<EOF
 
 * * * * *
 
 The script has been successfully completed.
 
-To see the mdbook live on your browser with the SSH tunnel, 
+To see the mdbook live on your browser, 
 run the following command with the proper port (here we use 3333).
 
-mdbook serve --port 3333
+mdbook serve --hostname 0.0.0.0 --port 3333
 
 Happy mdbooking!
 
 * * * * *
 
 EOF
+
+# Send stderr to null and exit gracefully
 return 2> /dev/null; exit
\ No newline at end of file

From cc8b0e67e8649b99389e2a991eb4d263fb10bd2c Mon Sep 17 00:00:00 2001
From: mik-tf <perreault@incubaid.com>
Date: Fri, 16 Feb 2024 13:34:47 +0000
Subject: [PATCH 15/15] Update README.md

adjusted links to docs
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 864aa2f..d2251be 100644
--- a/README.md
+++ b/README.md
@@ -15,7 +15,7 @@ hero -help
 source ~/.zprofile 
 ```
 
-There is also a quick guide on setting mdbook and hero on a full VM running on the TFGrid. Read the [docs](./docs/hero_mdbook_fullvm.md) for more information.
+There is also a [quick guide](./docs/hero_mdbook_fullvm.md) and a [script](./docs/hero_mdbook_fullvm_script.md) on setting mdbook and hero on a full VM running on the TFGrid. Read the [docs](./docs) for more information.
 
 ## to run the book