Merge pull request ComputationalRadiationPhysics#2519 from ax3l/doc-startInstallPath

Docs: Stream-line Intro

Author: PrometheusPi

docs/source/index.rst

@@ -10,24 +10,24 @@
 *A particle-in-cell code for GPGPUs*
 
 PIConGPU is a fully relativistic, many GPGPU, 3D3V particle-in-cell (PIC) code.
-The Particle-in-Cell algorithm is a central tool in plasma physics.
+The PIC algorithm is a central tool in plasma physics.
 It describes the dynamics of a plasma by computing the motion of electrons and ions in the plasma based on Maxwell's equations.
 
 How to Read This Document
 -------------------------
 
-Generally, you want to follow those pages in-order to get started.
+Generally, **follow the manual pages in-order** to get started.
 Individual chapters are based on the information of the chapters before.
-
 In case you are already fluent in compiling C++ projects and HPC, running PIC simulations or scientific data analysis feel free to jump the respective sections.
 
-.. attention::
-   This documentation is just getting started.
-   Learn more about how to improve it :ref:`here <development-sphinx>` and please contribute via pull requests! :-)
+.. only:: html
+
+   The online version of this document is **versioned** and shows by default the manual of the last *stable* version of PIConGPU.
+   If you are looking for the latest *development* version, `click here <https://picongpu.readthedocs.io/en/latest/>`_.
+
 
-.. note::
-   We also have a `wiki`_
-   and a general `official homepage`_
+We are migrating our `wiki`_ to this manual, but some pages might still be missing.
+We also have an `official homepage`_ .
 
 .. _wiki: https://github.com/ComputationalRadiationPhysics/picongpu/wiki
 .. _official homepage: http://picongpu.hzdr.de

docs/source/install/path.rst

@@ -11,17 +11,23 @@ The first part is usually the job of a system administrator while the second par
 Depending on your experience, role, computing environment and expectations for optimal hardware utilization, you have several ways to install and select PIConGPU's dependencies.
 Choose your favorite *install and environment management method* below, young padavan, and follow the corresponding sections of the next chapters.
 
-Before you Start
-----------------
+Ways to Install
+---------------
+
+Choose *one* of the install methods below to get started:
+
+Load Modules
+^^^^^^^^^^^^
+
+On HPC systems and clusters, software is usually provided by system administrators via a module system (e.g. [modules]_, [Lmod]_).
+In case our :ref:`software dependencies <install-dependencies>` are available, we usually create a file in our ``$HOME`` named :ref:`<queueName>_picongpu.profile <install-profile>`.
+It loads according modules and sets :ref:`helper environment variables <install-dependencies-picongpu>`.
 
 .. important::
 
    For many HPC systems we already prepared and maintain an environment for you which will run out-of-the-box.
    See if yours is :ref:`in the list <install-profile>` so you can skip the installation completely!
 
-Ways to Install
----------------
-
 Spack
 ^^^^^