diff --git a/doc/api_distributed.md b/doc/api_distributed.md
index 1478022c7ea7ce341682a8af3103452d9428bf00..077704e01c3fd70f699d34d9045c517799200292 100644
--- a/doc/api_distributed.md
+++ b/doc/api_distributed.md
@@ -24,7 +24,7 @@ on all GPUs.
 ## Python code
 
 We can start from the codebase of the fully convolutional model example 
-described in the OTBTF [Python API tutorial](#api_tutorial.html).
+described in the OTBTF [Python API tutorial](api_tutorial.html).
 
 ### Dataset
 
diff --git a/doc/deprecated.md b/doc/deprecated.md
index c0477962cb43ac9c43e08c336c18beeb6a6c7623..3f76c1dbd1d62e3313da1e85e4d3b8e8ecef8bdf 100644
--- a/doc/deprecated.md
+++ b/doc/deprecated.md
@@ -35,4 +35,4 @@ training, etc. is done using the so-called `tensorflow.Strategy`
 
 !!! Note
 
-    Read our [tutorial](#api_tutorial.html) to know more on working with Keras!
\ No newline at end of file
+    Read our [tutorial](api_tutorial.html) to know more on working with Keras!
\ No newline at end of file
diff --git a/doc/docker_build.md b/doc/docker_build.md
index c7a3c1e97e5030760d79c2b1429578b12d32f4cb..debc1ea8d5ae2994949b46a61e70a5ed14290ce3 100644
--- a/doc/docker_build.md
+++ b/doc/docker_build.md
@@ -49,7 +49,7 @@ be a different branch of OTB, bazel cache will help you to rebuild everything
 except TF, even if the docker cache was purged (after `docker 
 [system|builder] prune`).
 In order to recycle the cache, bazel config and TF git tag should be exactly 
-the same, any change in [build-env-tf.sh](build-env-tf.sh) and `--build-arg` 
+the same, any change in *tools/docker/build-env-tf.sh* and `--build-arg` 
 (if related to bazel env, cuda, mkl, xla...) may result in a fresh new build.
 
 Start a cache daemon - here with max 20GB but 10GB should be enough to save 2 
diff --git a/doc/docker_use.md b/doc/docker_use.md
index 47749325def9c1ab1ae2d162bcb6abb236909fe6..ebbab5a492f122be2e690c1497544c31a2e4d708 100644
--- a/doc/docker_use.md
+++ b/doc/docker_use.md
@@ -104,7 +104,7 @@ Troubleshooting:
 
 If you want to use optimization flags, change GPUs compute capability, etc. 
 you can build your own docker image using the provided dockerfile. 
-See the [docker build documentation](#docker_build.html).
+See the [docker build documentation](docker_build.html).
 
 ## Older images
 
diff --git a/doc/index.md b/doc/index.md
index 976b739af379993c224160bb670006523834a560..f96bb5cb09e46b7302f3d3f463b8f69175707fc2 100644
--- a/doc/index.md
+++ b/doc/index.md
@@ -16,7 +16,7 @@
 
 
 This remote module of the [Orfeo ToolBox](https://www.orfeo-toolbox.org) 
-provides a generic, multi-purpose deep learning framework, targeting remote 
+provides a generic, multipurpose deep learning framework, targeting remote 
 sensing images processing. It contains a set of new process objects for OTB 
 that internally invoke [Tensorflow](https://www.tensorflow.org/), and new [OTB 
 applications](#otb-applications) to perform deep learning with real-world