diff --git a/doc/examples/README.rst b/doc/examples/README.rst
index 921bcf2a38..0a647c15e3 100644
--- a/doc/examples/README.rst
+++ b/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
\ No newline at end of file
diff --git a/doc/examples/quick_start/README.rst b/doc/examples/quick_start/README.rst
index 7fb8f046a7..a917ac8825 100644
--- a/doc/examples/quick_start/README.rst
+++ b/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
diff --git a/doc/using/Foreign.rst b/doc/using/Foreign.rst
index cdbeeace38..cca810eb95 100644
--- a/doc/using/Foreign.rst
+++ b/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
 ====================