Rearranged a bit to have troubleshooting linked on the front page and…

… mentioned last in getting started.
ucphhpc · Apr 2, 2024 · 7cf2fbb · 7cf2fbb
1 parent 8b157f4
commit 7cf2fbb
Show file tree

Hide file tree

Showing 2 changed files with 14 additions and 8 deletions.
diff --git a/doc/source/index.rst b/doc/source/index.rst
@@ -12,38 +12,45 @@ Welcome to Docker MiGrid
 Docker MiGrid provides a prepackaged build of the Minimum Intrusion Grid (MiG) middleware system.
 It does this, by building and deploying the MiG across a number of Docker containers, that each is tasked with delievering a single or multiple MiG service(s).
 
-To jump right into having your own version of MiGrid deployed, please have a look at the Gettings Started section.
+To jump right into having your own version of MiGrid deployed, please
+read on in
 
 .. toctree::
    :maxdepth: 2
 
    sections/getting-started/index
 
-For information about how Docker MiGrid, and the MiG itself can be configured, please have a look at.
+For information about how Docker MiGrid, and the MiG itself can be configured, please have a look at
 
 .. toctree::
    :maxdepth: 2
 
    sections/configuration/index
 
-For an overview of the overall architecture for both Docker MiGrid and the underlying MiG, please refer to.
+In case something doesn't behave as expected when running your own site perhaps you can find some relevant pointers in
+
+.. toctree::
+   :maxdepth: 2
+
+   sections/troubleshooting/index
+
+For an overview of the overall architecture for both Docker MiGrid and the underlying MiG, please refer to
 
 .. toctree::
    :maxdepth: 2
 
    sections/architecture/index
 
-The story behind the MiG can be discovered in the Background section.
+The story behind the MiG can be discovered in
 
 .. toctree::
    :maxdepth: 2
 
    sections/background/index
 
-Finally, if you wish to contribute to this project, you can find details on how to do this in the section below.
+Finally, if you wish to participate or help with the docker-migrid project out you can find details on how to do that in
 
 .. toctree::
    :maxdepth: 2
 
    sections/contribution/index
-
diff --git a/doc/source/sections/getting-started/index.rst b/doc/source/sections/getting-started/index.rst
@@ -11,7 +11,6 @@ You have to go through the following numerical steps, in order to have a fully f
     prerequisites
     building
     deploying
-    ../troubleshooting/index
 
 
-We include a step-by-step example of a set up we did on :doc:`Rocky 8.5 <case-studies/rocky8>` for illustration.
+We include a step-by-step example of a set up we did on :doc:`Rocky-8 <case-studies/rocky8>` for illustration and some hints for :doc:`troubleshooting <../troubleshooting>` any issues.