Minor doc impr from umarcor/pull/1

doc/examples/README.rst

@@ -3,10 +3,10 @@
 Examples
 ########
 
-This sections contains advanced examples using specific features of the language, the tool,
-or interaction with third-party projects. It is suggested for users who are new to either
-`GHDL` or `VHDL` to read :ref:`USING:QuickStart` first.
+It is suggested that users who are new to either `GHDL` or `VHDL` read, and execute, the examples in :ref:`USING:QuickStart` first.
 
-.. toctree::
+The following sections contain advanced examples using specific features of the language, the tool,
+or interaction with third-party projects. 
 
-   ../examples/VHPIDIRECT
+- `ghld-cosim <https://github.com/ghdl/ghdl-cosim>`_ is centered around accessing the GHDL simulation, or data used in the simulation, from another program and vice-versa.
+- ... More to be made

doc/examples/quick_start/README.rst

@@ -26,7 +26,7 @@ The following tips might be useful:
 
   * Use :option:`--ieee=synopsys <--ieee>` if your design depends on a non-standard implementation of the IEEE library.
 
-  * Use :option:`-fexplicit` and :option:`-frelaxed-rules` if needed.
+  * Use :option:`-fexplicit` and :option:`-frelaxed-rules` if needed. For instance when relaxing VHDL 2008's need for shared variables to be protected types, you can use `--std=08 -frelaxed`.
 
 * Use :option:`--work=LIB_NAME <--work>` to analyze files into the ``LIB_NAME`` library.
   To use files analyzed to a different directory, give the path

doc/using/Foreign.rst

@@ -27,6 +27,7 @@ You can define a subprogram in a foreign language (such as `C` or
 .. ATTENTION::
   As a consequence of the runtime copyright, you are not allowed to distribute an executable produced by GHDL without allowing access to the VHDL sources. See :ref:`INTRO:Copyrights`.
 
+.. _foreign_declarations:
 
 Foreign declarations
 ====================