docu: adds "Getting started" to main page

doc/src/mainpage.dox

@@ -2,28 +2,26 @@
 #
 # SPDX-License-Identifier: CC-BY-4.0
 
-/** @mainpage
+/** @mainpage A coupling library for Earth System Models
+
+\tableofcontents
 
 \image html yak_small.jpg
 
-<h2>Autors</h2>
+\section main_getting_started Getting started
 
-Moritz Hanke, Nils-Arne Dreier, and Ren&eacute; Redler
+\ref installing_yac "Information on how to install YAC"
 
-<h2>References</h2>
+\ref usage "Guide to user interface"
 
-Moritz Hanke, Ren&eacute; Redler, Teresa Holfeld und Maxim Yastremsky, 2016: YAC 1.2.0: new aspects for coupling software in Earth system modelling. Geoscientific Model Development, 9, 2755-2769. <a href="https://doi.org/10.5194/gmd-9-2755-2016">DOI:10.5194/gmd-9-2755-201</a>.
+\section main_extended Extended documenation
 
-Moritz Hanke und Ren&eacute; Redler, 2019: New features with YAC 1.5.0. Reports on ICON, No 3. DOI: <a href="https://doi.org/10.5676/DWD_pub/nwv/icon_003">10.5676/DWD_pub/nwv/icon_003</a>.
-
-<h2>Table of Contents</h2>
-
-- \ref general_info
+- \subpage general_info
   - \ref license
   - \ref availability
   - \ref rationale
   - \ref version_info
-- \ref yac_components
+- \subpage yac_components
   - \ref installing_yac
   - \ref yac_libs_core
     - \ref interp_main
@@ -36,7 +34,17 @@ Moritz Hanke und Ren&eacute; Redler, 2019: New features with YAC 1.5.0. Reports
     - \ref pythonbindings
   - \ref yac_libs_utils
 
-<h2>Copyright</h2>
+\section main_yac_author YAC Autors
+
+Moritz Hanke, Nils-Arne Dreier, and Ren&eacute; Redler
+
+\section main_references References
+
+Moritz Hanke, Ren&eacute; Redler, Teresa Holfeld und Maxim Yastremsky, 2016: YAC 1.2.0: new aspects for coupling software in Earth system modelling. Geoscientific Model Development, 9, 2755-2769. <a href="https://doi.org/10.5194/gmd-9-2755-2016">DOI:10.5194/gmd-9-2755-201</a>.
+
+Moritz Hanke und Ren&eacute; Redler, 2019: New features with YAC 1.5.0. Reports on ICON, No 3. DOI: <a href="https://doi.org/10.5676/DWD_pub/nwv/icon_003">10.5676/DWD_pub/nwv/icon_003</a>.
+
+\section main_copyright Copyright
 
 Copyright 2018 by DKRZ and MPI-M.