GEOS-DEV · paloma-martinez · Nov 24, 2025 · Nov 25, 2025 · Nov 26, 2025 · Nov 26, 2025
diff --git a/docs/geos-ats.rst b/docs/geos-ats.rst
@@ -1,16 +1,16 @@
 
-GEOS ATS
+ATS
 ==========
 
 The `geos-ats` python package includes tools for managing integrated tests for GEOS.
 It is built using the `Automated Test System <https://ats.readthedocs.io/en/latest/>`_ (ATS) package.
 The available console scripts for this package and its API are described below.
 
 
-run_geos_ats
-----------------
+Usage
+--------
 
-Primary entry point for running integrated tests.
+`run_geos_ats` is the primary entry point for running integrated tests.
 
 .. argparse::
    :module: geos.ats.command_line_parsers

diff --git a/docs/geos-geomechanics.rst b/docs/geos-geomechanics.rst
diff --git a/docs/geos-processing.rst b/docs/geos-processing.rst
diff --git a/docs/geos-pv.rst b/docs/geos-pv.rst
diff --git a/docs/geos-timehistory.rst b/docs/geos-timehistory.rst
@@ -2,5 +2,17 @@
 Time History Tools
 --------------------------
 
+The `geos-timehistory` package contains tools to treat and plot time-history data from GEOS output.
+
+Usage
+^^^^^^^^
+
+.. program-output:: python ../geos-timehistory/src/geos/timehistory/plot_time_history.py --help
+
+
+API
+^^^^
+
 .. automodule:: geos.timehistory.plot_time_history
     :members:
+
diff --git a/docs/geos-utils.rst b/docs/geos-utils.rst
@@ -1,73 +1,72 @@
-
-GEOS Utilities
+Utilities
 ===============
 
 The `geos-utils` python package defines utilities for all GEOS python packages including a logger, GEOS constants, basic functions, and unit management tools.
 
 
-API
-^^^
-
-geos.utils.ConnectionSet module
+ConnectionSet module
 --------------------------------
 
 .. automodule:: geos.utils.ConnectionSet
    :members:
    :undoc-members:
    :show-inheritance:
 
-geos.utils.enumUnits module
+enumUnits module
 --------------------------------
 
 .. automodule:: geos.utils.enumUnits
    :members:
    :undoc-members:
    :show-inheritance:
-   
-geos.utils.geometryFunctions module
+
+geometryFunctions module
 ------------------------------------
 
 .. automodule:: geos.utils.geometryFunctions
    :members:
    :undoc-members:
    :show-inheritance:
 
-geos.utils.GeosOutputsConstants module
+
+GeosOutputsConstants module
 -------------------------------------------
 
 .. automodule:: geos.utils.GeosOutputsConstants
    :members:
    :undoc-members:
    :show-inheritance:
 
-geos.utils.algebraFunctions module
+algebraFunctions module
 -------------------------------------------
 
 .. automodule:: geos.utils.algebraFunctions
    :members:
    :undoc-members:
    :show-inheritance:
 
-geos.utils.Logger module
+Logger module
 ------------------------------
 
 .. automodule:: geos.utils.Logger
    :members:
    :undoc-members:
    :show-inheritance:
 
-geos.utils.PhysicalConstants module
+.. _output-constant:
+
+PhysicalConstants module
 -----------------------------------------
 
 .. automodule:: geos.utils.PhysicalConstants
    :members:
    :undoc-members:
    :show-inheritance:
 
-geos.utils.UnitRepository module
+UnitRepository module
 -------------------------------------
 
 .. automodule:: geos.utils.UnitRepository
    :members:
    :undoc-members:
-   :show-inheritance:
+   :show-inheritance:
diff --git a/docs/geos_geomechanics_docs/geos-geomechanics.rst b/docs/geos_geomechanics_docs/geos-geomechanics.rst
@@ -0,0 +1,12 @@
+GEOS Geomechanics tools
+=============================
+
+This package contains geomechanics functions and data models.
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+   model
+
+   processing
diff --git a/docs/geos_geomechanics_docs/home.rst b/docs/geos_geomechanics_docs/home.rst
diff --git a/docs/geos_geomechanics_docs/model.rst b/docs/geos_geomechanics_docs/model.rst
@@ -1,18 +1,18 @@
-Geomechanics models
-======================
+Models
+=============
 
 This module defines data structures for geomechanics calculations.
 
-geos.geomechanics.model.MohrCircle module
-------------------------------------------
+Mohr circle
+-----------------
 
 .. automodule:: geos.geomechanics.model.MohrCircle
    :members:
    :undoc-members:
    :show-inheritance:
 
-geos.geomechanics.model.MohrCoulomb module
--------------------------------------------
+Mohr-Coulomb failure envelop
+-------------------------------
 
 .. automodule:: geos.geomechanics.model.MohrCoulomb
    :members:

diff --git a/docs/geos_geomechanics_docs/modules.rst b/docs/geos_geomechanics_docs/modules.rst
diff --git a/docs/geos_geomechanics_docs/processing.rst b/docs/geos_geomechanics_docs/processing.rst
@@ -3,8 +3,8 @@ Processing
 
 The processing part of `geos-geomechanics` package contains the basis functions to compute geomechanical properties.
 
-geos.geomechanics.processing.geomechanicsCalculatorFunctions module
----------------------------------------------------------------------
+Geomechanical properties
+-----------------------------------
 
 .. automodule:: geos.geomechanics.processing.geomechanicsCalculatorFunctions
    :members:

diff --git a/docs/geos-mesh.rst → docs/geos_mesh_docs/geos-mesh.rst b/docs/geos-mesh.rst → docs/geos_mesh_docs/geos-mesh.rst
@@ -7,12 +7,12 @@ GEOS Mesh tools
       :maxdepth: 1
       :caption: Contents:
 
-      ./geos_mesh_docs/converter
+      ./converter
 
-      ./geos_mesh_docs/io
+      ./io
 
-      ./geos_mesh_docs/model
+      ./model
 
-      ./geos_mesh_docs/stats
+      ./stats
 
-      ./geos_mesh_docs/utils
+      ./utils
diff --git a/docs/geos_processing_docs/generic_processing_tools.rst b/docs/geos_processing_docs/generic_processing_tools.rst
@@ -4,53 +4,53 @@ Generic processing filters
 The `generic_processing_tools` module of `geos-processing` package contains filters to process meshes.
 
 
-geos.processing.generic_processing_tools.AttributeMapping filter
-----------------------------------------------------------------
+AttributeMapping
+---------------------
 
 .. automodule:: geos.processing.generic_processing_tools.AttributeMapping
    :members:
    :undoc-members:
    :show-inheritance:
 
 
-geos.processing.generic_processing_tools.CreateConstantAttributePerRegion filter
---------------------------------------------------------------------------------
+CreateConstantAttributePerRegion
+--------------------------------------
 
 .. automodule:: geos.processing.generic_processing_tools.CreateConstantAttributePerRegion
     :members:
     :undoc-members:
     :show-inheritance:
 
 
-geos.processing.generic_processing_tools.FillPartialArrays filter
------------------------------------------------------------------
+FillPartialArrays
+------------------------
 
 .. automodule:: geos.processing.generic_processing_tools.FillPartialArrays
     :members:
     :undoc-members:
     :show-inheritance:
 
 
-geos.processing.generic_processing_tools.SplitMesh filter
----------------------------------------------------------
+SplitMesh
+-------------------------
 
 .. automodule:: geos.processing.generic_processing_tools.SplitMesh
     :members:
     :undoc-members:
     :show-inheritance:
 
 
-geos.processing.generic_processing_tools.MergeBlockEnhanced filter
-------------------------------------------------------------------
+MergeBlockEnhanced
+----------------------------------
 
 .. automodule:: geos.processing.generic_processing_tools.MergeBlockEnhanced
     :members:
     :undoc-members:
     :show-inheritance:
 
 
-geos.processing.generic_processing_tools.ClipToMainFrame filter
----------------------------------------------------------------
+ClipToMainFrame
+------------------------------
 
 .. automodule:: geos.processing.generic_processing_tools.ClipToMainFrame
     :members:

diff --git a/docs/geos_processing_docs/geos-processing.rst b/docs/geos_processing_docs/geos-processing.rst
@@ -0,0 +1,14 @@
+Processing tools
+========================
+
+The `geos-processing` package contains different tools to prepare, post-process or analyze GEOS data, from surface geomechanics calculation to attribute mapping from one mesh to another.
+
+.. toctree::
+    :maxdepth: 2
+    :caption: Contents:
+
+    generic_processing_tools.rst
+
+    pre_processing.rst
+
+    post_processing.rst
diff --git a/docs/geos_processing_docs/post_processing.rst b/docs/geos_processing_docs/post_processing.rst
@@ -10,7 +10,7 @@ GEOS computes many outputs including flow and geomechanic properties if coupled
 
 .. Note::
 
-    Several processing filters require the definition of physical parameters. The following list is non-exhaustive.
+    Several processing filters require the definition of physical parameters. The following list is non-exhaustive. See :ref:`output-constant`.
 
     Default values:
     - grainBulkModulus = 38e9 Pa ( quartz value )
@@ -19,34 +19,34 @@ GEOS computes many outputs including flow and geomechanic properties if coupled
     - friction angle: 10°
 
 
-geos.processing.post_processing.SurfaceGeomechanics
--------------------------------------------------------
+SurfaceGeomechanics
+-----------------------------
 
 .. automodule:: geos.processing.post_processing.SurfaceGeomechanics
     :members:
     :undoc-members:
     :show-inheritance:
 
 
-geos.processing.post_processing.GeomechanicsCalculator module
---------------------------------------------------------------
+GeomechanicsCalculator
+--------------------------------
 
 .. automodule:: geos.processing.post_processing.GeomechanicsCalculator
    :members:
    :undoc-members:
    :show-inheritance:
 
 
-geos.processing.post_processing.GeosBlockExtractor module
-----------------------------------------------------------
+GeosBlockExtractor
+------------------------------------
 
 .. automodule:: geos.processing.post_processing.GeosBlockExtractor
    :members:
    :undoc-members:
    :show-inheritance:
 
 
-geos.processing.post_processing.GeosBlockMerge module
+GeosBlockMerge
 -----------------------------------------------------
 
 .. automodule:: geos.processing.post_processing.GeosBlockMerge