tfgrid

* development:
  ...
  updated inca distribution info
  updated inca distribution info
  updated docker docs hero
  updated docker docks
  hero docker added pull step

README.md

@@ -1,58 +1,58 @@
-# Info for our new Internet / Social network
+<h1> TFGrid Docs</h1>
 
-> [https://info.ourworld.tf/duniayetu](https://info.ourworld.tf/duniayetu)
+<h2>Table of Contents</h2>
 
-## First install hero:
+- [Overview](#overview)
+- [Basic Hero mdBook Commands](#basic-hero-mdbook-commands)
+- [Install and Use Hero](#install-and-use-hero)
+- [Create a New mdBook](#create-a-new-mdbook)
+- [Contribute](#contribute)
+
+## Overview
+
+This repository contains TFGrid docs in the form of mdbooks generated with the [Hero](https://github.com/freeflowuniverse/crystallib/tree/development/cli/hero) tool.
+
+To see the whole list of books, check the [heroscript directory](https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript).
+
+## Basic Hero mdBook Commands
+
+Once Hero is set on your machine, you can run the following commands to preview mdbooks on your local browser:
+
+- Pull new changes
+    ```
+    hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/nameofyourbook -gp
+    ```
+
+- Build the book
+    ```
+    hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/nameofyourbook
+    ```
+- Preview on a web browser
+    ```
+    hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/nameofyourbook -o
+    ```
+
+> Note: You can use -p instead of -u and set a path to your heroscript directory, as explained in the [docs](https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/docs).
+
+## Install and Use Hero
+
+install hero as follows
 
 ```bash
-# Download the hero installer script
+curl https://raw.githubusercontent.com/freeflowuniverse/crystallib/development/scripts/installer_hero.sh | bash /tmp/hero_install.sh
-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
-hero -help
-# If it can't find hero, do the following on osx
-source ~/.zprofile 
 ```
 
-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.
+you can also do it on a VM (experts only)
 
-## to run the book
+To install and use Hero on a full VM running on the grid, read the [full VM guide](https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/docs/hero_mdbook_fullvm.md).
 
+## Create a New mdBook 
 
-```bash
+To create a new mdbook, read the [mdbook creation guide](https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/docs/hero_create_mdbook.md).
-hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/tfgrid
 
-# In case you want to open the generated book and edit
+## Contribute
-hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/tfgrid -e
-```
 
+To contribute to this repository, make a pull request of your changes. 
 
-## troubleshoot
+1. Fork the repository and make a pull requests with your changes
-
+2. If you have access, create a new branch in this repo and make a pull request with your changes
-### for Ubuntu, ...
-
-```bash
-apt update
-apt install curl -y
-```
-
-### for OSX
-
-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)"
-```
-