docs: Sphinx documentation fixes

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

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.