diff --git a/docs/source/index.rst b/docs/source/index.rst
index d09c2d3..e427724 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -9,11 +9,7 @@
IMAS PDS Manual
===============
-The **Pulse Design Simulator** couples the codes used to design an ITER pulse --
-NICE for free-boundary equilibrium, TORAX and METIS for transport, the
-Waveform-Editor for targets, PCSSP for magnetic control -- into simulations that
-run as a single job, exchanging IMAS data through
-`MUSCLE3 `_.
+The **Pulse Design Simulator** couples multiple different codes used to design a pulse, exchanging IMAS data through `MUSCLE3 `_.
Getting started
---------------
@@ -33,6 +29,103 @@ Getting started
case contains and where its output goes, and :ref:`workflows` which couplings are
available.
+Related documentation
+---------------------
+
+PDS couples different codes, so most of what you will
+need to read is maintained elsewhere. Below is an overview of what each tool does here, and where its
+own documentation and training live.
+
+MUSCLE3 and coupling
+^^^^^^^^^^^^^^^^^^^^
+
+.. list-table::
+ :header-rows: 1
+ :widths: 22 40 38
+
+ * - Module
+ - Role in PDS
+ - Documentation
+ * - ``IMAS-MUSCLE3``
+ - Collection of helper actors and for working with IMAS data in MUSCLE3 simulations.
+ - `Documentation `__,
+ `Training `__
+ * - ``MUSCLE3``
+ - The coupling framework itself: it starts the actors, connects their ports and
+ carries the messages between them.
+ - `Documentation `__,
+ `Training `__
+ * - ``yMMSL``
+ - The file format a workflow is written in.
+ - `Documentation `__
+ * - ``MUSCLE3 dashboard``
+ - Follows a running MUSCLE3 workflow live, and shows the recorder plots.
+ - `Repository `__
+ * - ``ymmsl2svg``
+ - Renders a MUSCLE3 workflow's coupling graph as SVG.
+ - `Repository `__
+
+IMAS and data
+^^^^^^^^^^^^^
+
+.. list-table::
+ :header-rows: 1
+ :widths: 22 40 38
+
+ * - Module
+ - Role in PDS
+ - Documentation
+ * - ``IMAS Data Dictionary``
+ - The data model itself: which IDSs exist and what is in them.
+ - `Documentation `__
+ * - ``IMAS-Python``
+ - Reading and writing the IMAS data that flows between the actors using Python.
+ - `Documentation `__,
+ `Training `__
+ * - ``IMAS-Validator``
+ - Rule-based checks on IDS contents; PDS uses it for the operational limit checks.
+ - `Documentation `__,
+ `Training `__
+
+Physics codes and pulse design
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. list-table::
+ :header-rows: 1
+ :widths: 22 40 38
+
+ * - Module
+ - Role in PDS
+ - Documentation
+ * - ``NICE``
+ - Free-boundary equilibrium, in inverse, direct and evolutive (resistive
+ diffusion) mode.
+ - `Documentation `__
+ * - ``TORAX``
+ - A core transport solver.
+ - `Documentation `__
+ * - ``TORAX-MUSCLE3``
+ - The MUSCLE3 actor wrapping TORAX, with its IMAS couplings.
+ - `Documentation `__
+ * - ``METIS-IRFM``
+ - Fast integrated transport that does a whole pulse on its own.
+ - `Repository `__ (ITER internal),
+ `Documentation `__
+ * - ``Waveform-Editor``
+ - Turns a ``waveforms.yaml`` into the target waveforms the solvers are driven
+ with, and carries the machine description.
+ - `Documentation `__,
+ `Training `__
+ * - ``PCS``
+ - The PCSSP magnetic controller (MATLAB/Simulink).
+ - `Repository `__ (ITER internal)
+ * - ``CHEASE``
+ - Fixed-boundary equilibrium.
+ - `Repository `__
+
+New to all of this? The trainings are the fastest way in: start with the
+:ref:`PDS training `.
+
.. toctree::
:caption: Getting Started
:maxdepth: 2
diff --git a/docs/source/installing.rst b/docs/source/installing.rst
index abddd80..f0b02a0 100644
--- a/docs/source/installing.rst
+++ b/docs/source/installing.rst
@@ -29,41 +29,6 @@ Loading the module
module use /work/projects/pds/modules/all
module load PDS
-The tool stack
---------------
-
-Only the first three are dependencies of ``PDS``. MUSCLE3 loads the rest when it starts
-the actor that needs them, which is why loading ``PDS`` is enough to run a workflow
-using any of them.
-
-.. list-table::
- :header-rows: 1
- :widths: 26 74
-
- * - Module
- - Role
- * - ``IMAS-Python``
- - Reading and writing IMAS data.
- * - ``IMAS-MUSCLE3``
- - The MUSCLE3 manager plus the generic actors (source, sink, recorder,
- validator, ...).
- * - ``ymmsl2svg``
- - Renders a workflow's coupling graph as SVG.
- * - ``NICE``
- - Free-boundary equilibrium: inverse, direct and evolutive solvers.
- * - ``TORAX-MUSCLE3``
- - Core transport.
- * - ``METIS-IRFM``
- - Fast integrated transport, driven through MATLAB.
- * - ``Waveform-Editor``
- - Turns a ``waveforms.yaml`` into the target waveforms sent to the solvers.
- * - ``PCS``
- - The PCSSP magnetic controller, MATLAB/Simulink.
- * - ``CHEASE``
- - Fixed-boundary equilibrium.
- * - ``IMAS-Validator``
- - Rule-based checks on IDS contents.
-
Verifying the install
---------------------