diff --git a/docs/hero_mdbook_docker.md b/docs/hero_mdbook_docker.md
index 490b018..e471cf3 100644
--- a/docs/hero_mdbook_docker.md
+++ b/docs/hero_mdbook_docker.md
@@ -16,7 +16,7 @@ You can then use a code editor, e.g. VSCodium, to change the files locally and u
 
 ## Prerequisites
 
-- [Docker engine](https://docs.docker.com/engine/install/ubuntu/) should be installed and running on Linux
+- [Docker Engine](https://docs.docker.com/engine/install/ubuntu/) should be installed and running on Linux
 - [Docker Desktop](https://www.docker.com/products/docker-desktop/) should be installed and running on MacOS and Windows
 - You need a git repository to work with (here we use **info_tfgrid**)
   - Clone the hero mdbook repo on your local machine (i.e. the host) and note the path
@@ -31,9 +31,13 @@ Once you've set Hero Docker, you can adjust the files at the host path in a code
 
 Note that you will need to adjust the local path of the git repo and the docker path of the git repo.
 
-- On a terminal window, start Hero docker
+- On a terminal window, create the code repository on the local machine
   ```
-  sudo docker run --name herodocker -d -v /local/machine/path/to/git/repo:/docker/path/to/git/repo/ ghcr.io/scottyeager/hero:latest
+  mkdir -p ~/code/git.ourworld.tf/tfgrid
+  ```
+- Start Hero docker
+  ```
+  sudo docker run --net=host --name herodocker -d -v ~/code/git.ourworld.tf/tfgrid:~/code/git.ourworld.tf/tfgrid ghcr.io/scottyeager/hero:latest
   ```
   - In our case, the docker path to the repo is the following
     ```
@@ -43,6 +47,10 @@ Note that you will need to adjust the local path of the git repo and the docker
   ```
   sudo docker exec -it herodocker bash
   ```
+- Change directory
+  ```
+  cd ~/code/git.ourworld.tf/tfgrid
+  ```
 - Git configuration
   - Set git lobally with a safe directory
     ```
diff --git a/docs/mdbook_basics.md b/docs/mdbook_basics.md
index 89f565e..28435af 100644
--- a/docs/mdbook_basics.md
+++ b/docs/mdbook_basics.md
@@ -80,7 +80,5 @@ choco install mdbook
 
 - 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
\ No newline at end of file
+- [Deploy a Hero Mdbook on Docker](./hero_mdbook_docker.md)
+- [Create a Hero Mdbook](./hero_create_mdbook.md)
\ No newline at end of file