docs/mdbook_basics.md

@@ -0,0 +1,86 @@
+<h1>Introduction to Mdbook and Hero Mdbook</h1>
+
+<h2>Table of Contents</h2>
+
+- [Introduction](#introduction)
+- [Installation](#installation)
+  - [MacOS or Linux](#macos-or-linux)
+  - [Windows](#windows)
+    - [Install Chocolatey](#install-chocolatey)
+    - [Install Mdbook](#install-mdbook)
+- [Create a New Mdbook](#create-a-new-mdbook)
+- [More Information](#more-information)
+
+---
+
+## Introduction
+
+We introduce Mdbook and Hero Mdbook.
+
+## Installation
+
+### MacOS or Linux
+
+- Install Brew
+  ``` 
+  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+  ```
+- Install cargo
+  ``` 
+  brew install --cask cargo
+  ```
+- Install mdbook
+  ```
+  cargo install mdbook
+  ```
+
+### Windows 
+
+#### Install Chocolatey
+
+To install Chocolatey on Windows, we follow the [official Chocolatey website](https://chocolatey.org/install) instructions.
+
+* Run PowerShell as Administrator
+* Check if **Get-ExecutionPolicy** is restricted
+  * ```
+    Get-ExecutionPolicy
+    ```
+  * If it is restricted, run the following command:
+    * ```
+      Set-ExecutionPolicy AllSigned
+      ```
+* Install Chocolatey
+  * ```
+    Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
+    ```
+* Note: You might need to restart PowerShell to use Chocolatey
+
+#### Install Mdbook
+
+```
+choco install mdbook
+```
+
+## Create a New Mdbook
+
+- Open a terminal
+- Create a new directory
+    ```
+    mkdir -p mdbook_folder
+    cd mdbook_folder
+    ```
+- Initialize an mdbook book
+    ```
+    mdbook init
+    ```
+- Create new sections with SUMMARY.md
+- Populate the content in the ̀`src` folder
+
+## More Information
+
+- Update an mdbook on a GitHub repo
+  - https://manual.grid.tf/knowledge_base/collaboration/contribute.html
+- Deploy a Hero Mdbook on Docker
+  - https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/development/docs/hero_mdbook_docker.md
+- Create a Hero Mdbook
+  - https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/development/docs/hero_create_mdbook.md