docs: Sphinx documentation fixes

Broken links, invalid chapter underlining, invalid code fragments, etc.

docs/examples/basics/glide_computer.rst

@@ -16,7 +16,7 @@ This example presents the usage of:
 .. literalinclude:: ../../../example/glide_computer/include/glide_computer.h
   :caption: glide_computer.h
   :start-at: #include
-  :end-before: using namespace units;
+  :end-at: // - flight path exactly on a shortest possible line to destination
   :linenos:
   :lineno-match:
 
@@ -37,7 +37,7 @@ For example we have 3 for a quantity of length:
 
 .. literalinclude:: ../../../example/glide_computer/include/glide_computer.h
   :caption: glide_computer.h
-  :start-at: using namespace units;
+  :start-after: // - flight path exactly on a shortest possible line to destination
   :end-before: // text output
   :linenos:
   :lineno-match:

docs/examples/kalman_filter/example_7.rst

@@ -1,5 +1,5 @@
 Example 7 - Estimating the temperature of the heating liquid I
-=============================================================
+==============================================================
 
 Implementation of: https://www.kalmanfilter.net/kalman1d.html#ex7
 

docs/examples/kalman_filter/example_8.rst

@@ -1,5 +1,5 @@
 Example 8 - Estimating the temperature of the heating liquid II
-==============================================================
+===============================================================
 
 Implementation of: https://www.kalmanfilter.net/kalman1d.html#ex8
 

docs/framework/quantities.rst

@@ -553,7 +553,7 @@ units like CGS.
 
 .. seealso::
 
-    Please refer to :ref:`examples/avg_speed:avg_speed` example for more
+    Please refer to :ref:`examples/basics/avg_speed:avg_speed` example for more
     information on different kinds of interfaces supported by the library.
 
 

docs/framework/quantity_kinds.rst

@@ -73,5 +73,5 @@ Now ``x`` coordinates can be constructed::
 
 .. seealso::
 
-    Please refer to :ref:`examples/glide_computer:glide_computer` example for more
+    Please refer to :ref:`examples/basics/glide_computer:glide_computer` example for more
     information on the quantity kinds usage.

docs/use_cases/custom_representation_types.rst

@@ -305,4 +305,4 @@ representation types with::
 
     For more examples of custom representation types usage please refer to the
     :ref:`use_cases/linear_algebra:Linear Algebra vs. Quantities` chapter and the
-    :ref:`examples/measurement:measurement` example.
+    :ref:`examples/custom_representation/measurement:measurement` example.

docs/use_cases/linear_algebra.rst

@@ -85,4 +85,4 @@ output:
 .. seealso::
 
     For more examples of Linear Algebra definition and operations please refer to
-    the :ref:`examples/linear_algebra:linear_algebra` example.
+    the :ref:`examples/custom_representation/linear_algebra:linear_algebra` example.

docs/use_cases/unknown_dimensions.rst

@@ -87,7 +87,7 @@ following::
 .. seealso::
 
     Another good example of unknown dimension usage can be found in the
-    :ref:`examples/box_example:box_example`::
+    :ref:`examples/basics/box_example:box_example`::
 
         std::cout << "float rise rate = " << box.fill_level(measured_mass) / fill_time << '\n';