From 178a798f9df656b9ee63607b5f963be3a0fa94c1 Mon Sep 17 00:00:00 2001
From: felix-russo <72298366+felix-russo@users.noreply.github.com>
Date: Mon, 6 Nov 2023 18:04:21 +0100
Subject: [PATCH 1/5] refactor!: move AMVF and IVF config explicitly (#2509)

Title says it all!

Might be breaking as now `config` must be moved in the parent scope.

It might be better to not move the `config` and pass it as a const reference, not sure though.
---
 Core/include/Acts/Vertexing/AdaptiveMultiVertexFinder.hpp | 4 ++--
 Core/include/Acts/Vertexing/AdaptiveMultiVertexFitter.hpp | 4 ++--
 Core/include/Acts/Vertexing/IterativeVertexFinder.hpp     | 4 ++--
 .../Vertexing/src/AdaptiveMultiVertexFinderAlgorithm.cpp  | 4 ++--
 .../Vertexing/src/IterativeVertexFinderAlgorithm.cpp      | 2 +-
 .../Core/Vertexing/AdaptiveMultiVertexFinderTests.cpp     | 8 ++++----
 .../Core/Vertexing/AdaptiveMultiVertexFitterTests.cpp     | 6 ++++--
 .../Core/Vertexing/IterativeVertexFinderTests.cpp         | 6 +++---
 8 files changed, 20 insertions(+), 18 deletions(-)

diff --git a/Core/include/Acts/Vertexing/AdaptiveMultiVertexFinder.hpp b/Core/include/Acts/Vertexing/AdaptiveMultiVertexFinder.hpp
index 3286f092e8b..ddee86676ef 100644
--- a/Core/include/Acts/Vertexing/AdaptiveMultiVertexFinder.hpp
+++ b/Core/include/Acts/Vertexing/AdaptiveMultiVertexFinder.hpp
@@ -169,7 +169,7 @@ class AdaptiveMultiVertexFinder {
   template <
       typename T = InputTrack_t,
       std::enable_if_t<std::is_same<T, BoundTrackParameters>::value, int> = 0>
-  AdaptiveMultiVertexFinder(Config& cfg,
+  AdaptiveMultiVertexFinder(Config cfg,
                             std::unique_ptr<const Logger> logger =
                                 getDefaultLogger("AdaptiveMultiVertexFinder",
                                                  Logging::INFO))
@@ -185,7 +185,7 @@ class AdaptiveMultiVertexFinder {
   /// object
   /// @param logger The logging instance
   AdaptiveMultiVertexFinder(
-      Config& cfg, std::function<BoundTrackParameters(InputTrack_t)> func,
+      Config cfg, std::function<BoundTrackParameters(InputTrack_t)> func,
       std::unique_ptr<const Logger> logger =
           getDefaultLogger("AdaptiveMultiVertexFinder", Logging::INFO))
       : m_cfg(std::move(cfg)),
diff --git a/Core/include/Acts/Vertexing/AdaptiveMultiVertexFitter.hpp b/Core/include/Acts/Vertexing/AdaptiveMultiVertexFitter.hpp
index 77083ca936b..e26b1e73ed2 100644
--- a/Core/include/Acts/Vertexing/AdaptiveMultiVertexFitter.hpp
+++ b/Core/include/Acts/Vertexing/AdaptiveMultiVertexFitter.hpp
@@ -147,7 +147,7 @@ class AdaptiveMultiVertexFitter {
   template <
       typename T = InputTrack_t,
       std::enable_if_t<std::is_same<T, BoundTrackParameters>::value, int> = 0>
-  AdaptiveMultiVertexFitter(Config& cfg,
+  AdaptiveMultiVertexFitter(Config cfg,
                             std::unique_ptr<const Logger> logger =
                                 getDefaultLogger("AdaptiveMultiVertexFitter",
                                                  Logging::INFO))
@@ -163,7 +163,7 @@ class AdaptiveMultiVertexFitter {
   /// object
   /// @param logger The logging instance
   AdaptiveMultiVertexFitter(
-      Config& cfg, std::function<BoundTrackParameters(InputTrack_t)> func,
+      Config cfg, std::function<BoundTrackParameters(InputTrack_t)> func,
       std::unique_ptr<const Logger> logger =
           getDefaultLogger("AdaptiveMultiVertexFitter", Logging::INFO))
       : m_cfg(std::move(cfg)),
diff --git a/Core/include/Acts/Vertexing/IterativeVertexFinder.hpp b/Core/include/Acts/Vertexing/IterativeVertexFinder.hpp
index db8b9716ecc..b32e3a0d1ea 100644
--- a/Core/include/Acts/Vertexing/IterativeVertexFinder.hpp
+++ b/Core/include/Acts/Vertexing/IterativeVertexFinder.hpp
@@ -142,7 +142,7 @@ class IterativeVertexFinder {
   template <
       typename T = InputTrack_t,
       std::enable_if_t<std::is_same<T, BoundTrackParameters>::value, int> = 0>
-  IterativeVertexFinder(Config& cfg,
+  IterativeVertexFinder(Config cfg,
                         std::unique_ptr<const Logger> logger = getDefaultLogger(
                             "IterativeVertexFinder", Logging::INFO))
       : m_cfg(std::move(cfg)),
@@ -156,7 +156,7 @@ class IterativeVertexFinder {
   /// @param func Function extracting BoundTrackParameters from InputTrack_t
   /// object
   /// @param logger The logging instance
-  IterativeVertexFinder(Config& cfg,
+  IterativeVertexFinder(Config cfg,
                         std::function<BoundTrackParameters(InputTrack_t)> func,
                         std::unique_ptr<const Logger> logger = getDefaultLogger(
                             "IterativeVertexFinder", Logging::INFO))
diff --git a/Examples/Algorithms/Vertexing/src/AdaptiveMultiVertexFinderAlgorithm.cpp b/Examples/Algorithms/Vertexing/src/AdaptiveMultiVertexFinderAlgorithm.cpp
index 881b3f55072..c3343e2ab72 100644
--- a/Examples/Algorithms/Vertexing/src/AdaptiveMultiVertexFinderAlgorithm.cpp
+++ b/Examples/Algorithms/Vertexing/src/AdaptiveMultiVertexFinderAlgorithm.cpp
@@ -103,7 +103,7 @@ ActsExamples::AdaptiveMultiVertexFinderAlgorithm::executeAfterSeederChoice(
   fitterCfg.annealingTool = annealingUtility;
   fitterCfg.minWeight = 0.001;
   fitterCfg.doSmoothing = true;
-  Fitter fitter(fitterCfg, logger().cloneWithSuffix("AMVFitter"));
+  Fitter fitter(std::move(fitterCfg), logger().cloneWithSuffix("AMVFitter"));
 
   typename Finder::Config finderConfig(std::move(fitter), seedFinder,
                                        ipEstimator, std::move(linearizer),
@@ -113,7 +113,7 @@ ActsExamples::AdaptiveMultiVertexFinderAlgorithm::executeAfterSeederChoice(
   finderConfig.maxIterations = 200;
 
   // Instantiate the finder
-  Finder finder(finderConfig, logger().cloneWithSuffix("AMVFinder"));
+  Finder finder(std::move(finderConfig), logger().cloneWithSuffix("AMVFinder"));
 
   // retrieve input tracks and convert into the expected format
 
diff --git a/Examples/Algorithms/Vertexing/src/IterativeVertexFinderAlgorithm.cpp b/Examples/Algorithms/Vertexing/src/IterativeVertexFinderAlgorithm.cpp
index add05bad76c..5b417a70ea8 100644
--- a/Examples/Algorithms/Vertexing/src/IterativeVertexFinderAlgorithm.cpp
+++ b/Examples/Algorithms/Vertexing/src/IterativeVertexFinderAlgorithm.cpp
@@ -88,7 +88,7 @@ ActsExamples::ProcessCode ActsExamples::IterativeVertexFinderAlgorithm::execute(
                            std::move(seeder), ipEst);
   finderCfg.maxVertices = 200;
   finderCfg.reassignTracksAfterFirstFit = false;
-  Finder finder(finderCfg, logger().cloneWithSuffix("Finder"));
+  Finder finder(std::move(finderCfg), logger().cloneWithSuffix("Finder"));
   Finder::State state(*m_cfg.bField, ctx.magFieldContext);
   Options finderOpts(ctx.geoContext, ctx.magFieldContext);
 
diff --git a/Tests/UnitTests/Core/Vertexing/AdaptiveMultiVertexFinderTests.cpp b/Tests/UnitTests/Core/Vertexing/AdaptiveMultiVertexFinderTests.cpp
index d0f916a8693..c9014b27eca 100644
--- a/Tests/UnitTests/Core/Vertexing/AdaptiveMultiVertexFinderTests.cpp
+++ b/Tests/UnitTests/Core/Vertexing/AdaptiveMultiVertexFinderTests.cpp
@@ -120,7 +120,7 @@ BOOST_AUTO_TEST_CASE(adaptive_multi_vertex_finder_test) {
   Finder::Config finderConfig(std::move(fitter), seedFinder, ipEstimator,
                               std::move(linearizer), bField);
 
-  Finder finder(finderConfig);
+  Finder finder(std::move(finderConfig));
   Finder::State state;
 
   auto csvData = readTracksAndVertexCSV(toolString);
@@ -278,7 +278,7 @@ BOOST_AUTO_TEST_CASE(adaptive_multi_vertex_finder_usertype_test) {
                               std::move(linearizer), bField);
   Finder::State state;
 
-  Finder finder(finderConfig, extractParameters);
+  Finder finder(std::move(finderConfig), extractParameters);
 
   auto csvData = readTracksAndVertexCSV(toolString);
   auto tracks = std::get<TracksData>(csvData);
@@ -421,7 +421,7 @@ BOOST_AUTO_TEST_CASE(adaptive_multi_vertex_finder_grid_seed_finder_test) {
   Finder::Config finderConfig(std::move(fitter), seedFinder, ipEst,
                               std::move(linearizer), bField);
 
-  Finder finder(finderConfig);
+  Finder finder(std::move(finderConfig));
   Finder::State state;
 
   auto csvData = readTracksAndVertexCSV(toolString);
@@ -569,7 +569,7 @@ BOOST_AUTO_TEST_CASE(
   Finder::Config finderConfig(std::move(fitter), seedFinder, ipEst,
                               std::move(linearizer), bField);
 
-  Finder finder(finderConfig);
+  Finder finder(std::move(finderConfig));
   Finder::State state;
 
   auto csvData = readTracksAndVertexCSV(toolString);
diff --git a/Tests/UnitTests/Core/Vertexing/AdaptiveMultiVertexFitterTests.cpp b/Tests/UnitTests/Core/Vertexing/AdaptiveMultiVertexFitterTests.cpp
index 19ecf2fb23f..589294ca371 100644
--- a/Tests/UnitTests/Core/Vertexing/AdaptiveMultiVertexFitterTests.cpp
+++ b/Tests/UnitTests/Core/Vertexing/AdaptiveMultiVertexFitterTests.cpp
@@ -124,7 +124,8 @@ BOOST_AUTO_TEST_CASE(adaptive_multi_vertex_fitter_test) {
   // Test smoothing
   fitterCfg.doSmoothing = true;
 
-  AdaptiveMultiVertexFitter<BoundTrackParameters, Linearizer> fitter(fitterCfg);
+  AdaptiveMultiVertexFitter<BoundTrackParameters, Linearizer> fitter(
+      std::move(fitterCfg));
 
   // Create positions of three vertices, two of which (1 and 2) are
   // close to one another and will share a common track later
@@ -378,7 +379,8 @@ BOOST_AUTO_TEST_CASE(adaptive_multi_vertex_fitter_test_athena) {
   // Test smoothing
   // fitterCfg.doSmoothing = true;
 
-  AdaptiveMultiVertexFitter<BoundTrackParameters, Linearizer> fitter(fitterCfg);
+  AdaptiveMultiVertexFitter<BoundTrackParameters, Linearizer> fitter(
+      std::move(fitterCfg));
 
   // Create first vector of tracks
   Vector3 pos1a(0.5_mm, -0.5_mm, 2.4_mm);
diff --git a/Tests/UnitTests/Core/Vertexing/IterativeVertexFinderTests.cpp b/Tests/UnitTests/Core/Vertexing/IterativeVertexFinderTests.cpp
index 3955c2c6369..cd1aefc2a4e 100644
--- a/Tests/UnitTests/Core/Vertexing/IterativeVertexFinderTests.cpp
+++ b/Tests/UnitTests/Core/Vertexing/IterativeVertexFinderTests.cpp
@@ -172,7 +172,7 @@ BOOST_AUTO_TEST_CASE(iterative_finder_test) {
 
     cfg.reassignTracksAfterFirstFit = true;
 
-    VertexFinder finder(cfg);
+    VertexFinder finder(std::move(cfg));
     VertexFinder::State state(*bField, magFieldContext);
 
     // Vector to be filled with all tracks in current event
@@ -389,7 +389,7 @@ BOOST_AUTO_TEST_CASE(iterative_finder_test_user_track_type) {
                              ipEstimator);
     cfg.reassignTracksAfterFirstFit = true;
 
-    VertexFinder finder(cfg, extractParameters);
+    VertexFinder finder(std::move(cfg), extractParameters);
     VertexFinder::State state(*bField, magFieldContext);
 
     // Same for user track type tracks
@@ -602,7 +602,7 @@ BOOST_AUTO_TEST_CASE(iterative_finder_test_athena_reference) {
   cfg.maximumChi2cutForSeeding = 49;
   cfg.significanceCutSeeding = 12;
 
-  VertexFinder finder(cfg);
+  VertexFinder finder(std::move(cfg));
   VertexFinder::State state(*bField, magFieldContext);
 
   auto csvData = readTracksAndVertexCSV(toolString);

From 7529e625f3629843fa3e341e9e7511e4b5785a5b Mon Sep 17 00:00:00 2001
From: Benjamin Huth <37871400+benjaminhuth@users.noreply.github.com>
Date: Mon, 6 Nov 2023 23:44:39 +0100
Subject: [PATCH 2/5] fix: Missing path in setup script (#2635)

The script does not setup the odd anymore because the path is missing
---
 Examples/Python/setup.sh.in | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Examples/Python/setup.sh.in b/Examples/Python/setup.sh.in
index 9fda6acc578..b670500e09e 100644
--- a/Examples/Python/setup.sh.in
+++ b/Examples/Python/setup.sh.in
@@ -25,6 +25,7 @@ export PYTHONPATH=$python_dir:$PYTHONPATH
 
 # Make ODD available if possible
 # This seems to be only reliable on Linux for now, not on MacOS
+odd_dir=$python_dir/../thirdparty/OpenDataDetector/factory
 if [ -d "$odd_dir" ]; then
     if [[ "$(uname -s)" == "Linux" ]]; then
         echo "INFO:    Found OpenDataDetector and set it up"

From 922e6d1b56c9c0c9a01febac9e2d91e4777c7571 Mon Sep 17 00:00:00 2001
From: Paul Gessinger <paul.gessinger@cern.ch>
Date: Tue, 7 Nov 2023 08:26:50 +0100
Subject: [PATCH 3/5] docs: Restructure and update the documentation - 2023
 edition (#2610)

This PR rationalizes the documentation a bit. The main points are

- Remove the documentation of the old standalone examples executables
- Restructure the core documentation to be less sprawling
- Move the figures from a central folder closer to the relevant source files
- Remove the full auto API documentation in favor of a combination of hard-coded documented symbols + an auto detection mechanism to catch when we references symbols somewhere
  - This reduces the time it takes to build the docs drastically
- Enable nitpicky generation, which will warn (and fail) if symbols are references that don't have a target.

- [x] Try to auto-generate API listings only for the elements we explicitly call out by class / func roles.

Blocked by:
- #2616
- #2617
- #2624
---
 .github/workflows/docs.yml                    |  38 +-
 Core/include/Acts/Definitions/Algebra.hpp     |   6 -
 Core/include/Acts/Propagator/AbortList.hpp    |   7 +-
 Core/include/Acts/Propagator/ActionList.hpp   |   7 +-
 .../Acts/Propagator/ConstrainedStep.hpp       |   4 -
 Core/include/Acts/Surfaces/ConeBounds.hpp     |   2 +-
 Core/include/Acts/Surfaces/CylinderBounds.hpp |   1 +
 .../include/Acts/Surfaces/CylinderSurface.hpp |   2 +-
 Core/include/Acts/Surfaces/DiamondBounds.hpp  |   1 +
 Core/include/Acts/Surfaces/DiscBounds.hpp     |   2 +
 Core/include/Acts/Surfaces/DiscSurface.hpp    |   2 +-
 Core/include/Acts/Surfaces/EllipseBounds.hpp  |   2 +
 Core/include/Acts/Surfaces/LineSurface.hpp    |   4 +-
 Core/include/Acts/Surfaces/PerigeeSurface.hpp |   2 +-
 Core/include/Acts/Surfaces/PlaneSurface.hpp   |   6 +-
 .../include/Acts/Surfaces/RectangleBounds.hpp |   2 +
 Core/include/Acts/Surfaces/StrawSurface.hpp   |   6 +-
 .../include/Acts/Surfaces/TrapezoidBounds.hpp |   2 +-
 .../Plugins/Geant4/Geant4DetectorElement.hpp  |   5 +-
 .../Geant4/Geant4DetectorSurfaceFactory.hpp   |   6 +-
 docs/CMakeLists.txt                           |  79 +---
 docs/Doxyfile                                 |  20 +-
 docs/_extensions/lazy_autodoc.py              | 179 +++++++++
 docs/conf.py                                  |  57 ++-
 .../figures/physmon/physmon_artifact.png      | Bin
 .../figures/physmon/physmon_checks.png        | Bin
 .../figures/physmon/physmon_report.png        | Bin
 .../figures/physmon/physmon_run.png           | Bin
 .../figures/release/milestone_drop.png        | Bin
 .../figures/release/milestones.png            | Bin
 .../figures/release/next_milestone.png        | Bin
 .../figures/release/select_all_closed.png     | Bin
 docs/contribution/physmon.md                  |   8 +-
 docs/contribution/release.md                  |   8 +-
 docs/core/clustering.md                       |   6 -
 docs/core/core.rst                            |  26 +-
 docs/core/eventdata.md                        | 134 +------
 docs/{ => core}/figures/bfield/field_cell.svg |   0
 docs/{ => core}/figures/bfield/quiver.png     | Bin
 .../figures/material}/MaterialAssignment.jpeg | Bin
 .../figures/material}/MaterialAveraging.jpeg  | Bin
 docs/core/geometry.md                         | 354 ------------------
 .../geometry/figures}/CylinderBounds.png      | Bin
 .../geometry/figures}/CylinderLayer.png       | Bin
 .../figures}/CylinderVolumeBounds.png         | Bin
 .../geometry/figures}/DetectorElement.png     | Bin
 .../geometry/figures}/DirectPortal.png        | Bin
 .../geometry/figures}/DiscBounds.png          | Bin
 .../geometry/figures}/DiscLayerAB.png         | Bin
 .../geometry/figures}/DiscLayerEB.png         | Bin
 .../geometry/figures}/EndcapGrid.png          | Bin
 .../geometry/figures}/GlueingABC.png          | Bin
 .../geometry/figures}/GlueingBC.png           | Bin
 .../geometry/figures}/LayerArray.png          | Bin
 .../geometry/figures}/NavigationABC.png       | Bin
 .../geometry/figures}/ODD_Detector.png        | Bin
 .../geometry/figures}/PlaneBounds.png         | Bin
 .../geometry/figures}/SharedPortal.png        | Bin
 .../geometry/figures}/VolumeBounds.png        | Bin
 docs/core/geometry/geometry_id.md             |  19 +
 docs/core/geometry/index.md                   |  24 ++
 docs/core/geometry/layerless/building.md      |  18 +
 .../layerless/layerless.md}                   |  24 +-
 docs/core/geometry/legacy/building.md         |  86 +++++
 docs/core/geometry/legacy/layers.md           |  34 ++
 docs/core/geometry/legacy/legacy.md           |  14 +
 docs/core/geometry/legacy/volumes.md          |  24 ++
 docs/core/geometry/material.md                |  42 +++
 docs/core/geometry/surfaces.md                | 111 ++++++
 docs/core/howto/index.md                      |   6 +
 docs/core/howto/material_mapping.md           |   8 +
 docs/core/magnetic_field.md                   |   9 +-
 docs/core/material.md                         |  20 +
 docs/core/material.rst                        |  79 ----
 .../misc}/figures/AxisBoundaryTypes.svg       |   0
 docs/core/{utilities => misc}/grid_axis.md    |   2 +-
 docs/core/misc/index.md                       |   7 +
 docs/core/{ => misc}/logging.md               |  39 +-
 docs/core/propagation.md                      |  21 +-
 .../figures/gsf_bethe_heitler_approx.svg      |   0
 .../reconstruction}/figures/gsf_overview.svg  |   0
 docs/core/reconstruction/index.md             |   9 +
 .../figures/seeding/3Dcoordinates.svg         |   0
 .../figures/seeding/impactParameter.svg       |   0
 .../figures/seeding/r-zCoordinates.svg        |   0
 .../figures/seeding/tripletsFormation.svg     |   0
 .../figures/seeding/x-yCoordinates.svg        |   0
 .../pattern_recognition.md                    |   7 +
 .../pattern_recognition}/seeding.md           |  41 +-
 .../pattern_recognition}/track_finding.md     |   9 +-
 .../preprocessing/clustering.md               |   6 +
 .../preprocessing/preprocessing.md            |   6 +
 .../preprocessing}/spacepoint_formation.md    |   4 +-
 .../{ => reconstruction}/track_fitting.md     |  28 +-
 docs/core/reconstruction/vertexing.md         |   6 +
 docs/core/vertexing.md                        |   6 -
 .../{visualization.rst => 3d.md}              |  37 +-
 .../visualization/figures}/AngularError.png   | Bin
 .../visualization/figures}/CartesianError.png | Bin
 .../visualization/figures}/CylinderLayer.png  | Bin
 .../visualization/figures}/Parameters.png     | Bin
 docs/core/visualization/index.md              |   7 +
 docs/core/visualization/svg.md                |   7 +
 docs/examples/alignment.md                    |   4 +
 docs/examples/digizier_config.md              |   1 -
 docs/examples/examples.rst                    |   6 +-
 .../{ => examples}/howto/add_new_algorithm.md | 125 ++++---
 docs/examples/{ => howto}/analysis_apps.rst   |   8 +-
 ...ation_config.md => digitization_config.md} |   0
 .../analysis_apps}/aa_mc_stacked_x0.gif       | Bin
 .../figures/analysis_apps}/aa_rp_layers.png   | Bin
 .../howto/figures/analysis_apps}/aa_ts_d0.png | Bin
 .../figures/analysis_apps}/aa_ts_nhits.png    | Bin
 .../ActsMaterialMappingAutoTuning.png         | Bin
 .../materialMapping/approach_layers.png       | Bin
 .../figures/materialMapping/boundaries.png    | Bin
 .../materialMapping/layers_for_volume_17.png  | Bin
 .../materialMapping/volumes_and_layers.png    | Bin
 docs/examples/howto/howto.md                  |  26 +-
 .../howto/material_mapping.rst}               |  21 +-
 docs/examples/howto/run_alignment.rst         |  56 ---
 .../howto/run_ckf_auto_tuning.rst             |   0
 docs/examples/howto/run_ckf_tracking.rst      |  60 ---
 docs/examples/howto/run_fatras.rst            | 174 ---------
 docs/examples/howto/run_seeding.rst           |  73 ----
 docs/examples/howto/run_sycl_seed_finding.rst | 111 ------
 docs/examples/howto/run_truth_tracking.rst    |  68 ----
 .../examples/howto/setup_and_run_vertexing.md | 137 -------
 docs/examples/material_mapping.md             |   1 -
 docs/fatras/fatras.md                         |   7 +
 docs/figures/CuboidVolumeBounds_decomp.gif    | Bin 6826 -> 0 bytes
 docs/figures/CylinderVolumeBounds_decomp.gif  | Bin 7317 -> 0 bytes
 .../DoubleTrapezoidVolumeBounds_decom.gif     | Bin 40894 -> 0 bytes
 docs/figures/SubtractedPlaneBounds.gif        | Bin 22485 -> 0 bytes
 docs/figures/TrapezoidVolumeBounds_decom.gif  | Bin 7468 -> 0 bytes
 docs/figures/VolumeShapes.gif                 | Bin 9070 -> 0 bytes
 docs/figures/{ => doxygen}/ConeBounds.gif     | Bin
 docs/figures/{ => doxygen}/CylinderBounds.gif | Bin
 .../figures/{ => doxygen}/CylinderSurface.png | Bin
 docs/figures/{ => doxygen}/DiamondBounds.svg  |   0
 docs/figures/{ => doxygen}/DiscBounds.gif     | Bin
 docs/figures/{ => doxygen}/DiscSurface.png    | Bin
 docs/figures/{ => doxygen}/EllipseBounds.png  | Bin
 docs/figures/{ => doxygen}/LineSurface.png    | Bin
 docs/figures/{ => doxygen}/PlaneSurface.png   | Bin
 .../RectangleBounds.gif}                      | Bin
 .../{ => doxygen}/RotatedTrapezoidBounds.gif  | Bin
 .../{ => doxygen}/SignOfDriftCircleD0.gif     | Bin
 .../figures/{ => doxygen}/TrapezoidBounds.gif | Bin
 docs/getting_started.md                       |  35 +-
 docs/howto/howto.md                           |  12 -
 docs/howto/material_mapping_and_validation.md |   2 -
 docs/howto/produce_digitizer_config.md        |   1 -
 .../run_material_mapping_auto_tuning.rst      |  90 -----
 docs/index.rst                                |  15 +-
 docs/known-warnings.txt                       |  10 +-
 docs/plugins/autodiff.md                      |   4 +
 docs/plugins/dd4hep.md                        |  10 +-
 .../DD4hepPlugin_DetElementStructure.jpg      | Bin
 .../figures}/sycl/count_duplets.png           | Bin
 .../figures}/sycl/duplet_search_matrix.png    | Bin
 .../figures}/sycl/flat_matrix.png             | Bin
 .../figures}/sycl/middle_duplet_indices.png   | Bin
 .../figures}/sycl/prefix_sum_array.png        | Bin
 .../figures}/tgeo/TGeoArb8_PlaneSurface.png   | Bin
 .../figures}/tgeo/TGeoBBox_PlaneSurface.png   | Bin
 .../figures}/tgeo/TGeoTrd1_PlaneSurface.png   | Bin
 .../tgeo/TGeoTrd2_PlaneSurface_xz.png         | Bin
 .../tgeo/TGeoTrd2_PlaneSurface_yz.png         | Bin
 .../tgeo/TGeoTube_CylinderSurface.png         | Bin
 .../figures}/tgeo/TGeoTube_DiscSurface.png    | Bin
 docs/plugins/tgeo.rst                         |  12 +-
 docs/requirements.txt                         |   2 +-
 docs/tracking.md                              |   6 +-
 174 files changed, 1072 insertions(+), 1743 deletions(-)
 create mode 100644 docs/_extensions/lazy_autodoc.py
 rename docs/{ => contribution}/figures/physmon/physmon_artifact.png (100%)
 rename docs/{ => contribution}/figures/physmon/physmon_checks.png (100%)
 rename docs/{ => contribution}/figures/physmon/physmon_report.png (100%)
 rename docs/{ => contribution}/figures/physmon/physmon_run.png (100%)
 rename docs/{ => contribution}/figures/release/milestone_drop.png (100%)
 rename docs/{ => contribution}/figures/release/milestones.png (100%)
 rename docs/{ => contribution}/figures/release/next_milestone.png (100%)
 rename docs/{ => contribution}/figures/release/select_all_closed.png (100%)
 delete mode 100644 docs/core/clustering.md
 rename docs/{ => core}/figures/bfield/field_cell.svg (100%)
 rename docs/{ => core}/figures/bfield/quiver.png (100%)
 rename docs/{figures => core/figures/material}/MaterialAssignment.jpeg (100%)
 rename docs/{figures => core/figures/material}/MaterialAveraging.jpeg (100%)
 delete mode 100644 docs/core/geometry.md
 rename docs/{figures/geometry => core/geometry/figures}/CylinderBounds.png (100%)
 rename docs/{figures/geometry => core/geometry/figures}/CylinderLayer.png (100%)
 rename docs/{figures/geometry => core/geometry/figures}/CylinderVolumeBounds.png (100%)
 rename docs/{figures/geometry => core/geometry/figures}/DetectorElement.png (100%)
 rename docs/{figures/geometry => core/geometry/figures}/DirectPortal.png (100%)
 rename docs/{figures/geometry => core/geometry/figures}/DiscBounds.png (100%)
 rename docs/{figures/geometry => core/geometry/figures}/DiscLayerAB.png (100%)
 rename docs/{figures/geometry => core/geometry/figures}/DiscLayerEB.png (100%)
 rename docs/{figures/geometry => core/geometry/figures}/EndcapGrid.png (100%)
 rename docs/{figures/geometry => core/geometry/figures}/GlueingABC.png (100%)
 rename docs/{figures/geometry => core/geometry/figures}/GlueingBC.png (100%)
 rename docs/{figures/geometry => core/geometry/figures}/LayerArray.png (100%)
 rename docs/{figures/geometry => core/geometry/figures}/NavigationABC.png (100%)
 rename docs/{figures/geometry => core/geometry/figures}/ODD_Detector.png (100%)
 rename docs/{figures/geometry => core/geometry/figures}/PlaneBounds.png (100%)
 rename docs/{figures/geometry => core/geometry/figures}/SharedPortal.png (100%)
 rename docs/{figures/geometry => core/geometry/figures}/VolumeBounds.png (100%)
 create mode 100644 docs/core/geometry/geometry_id.md
 create mode 100644 docs/core/geometry/index.md
 create mode 100644 docs/core/geometry/layerless/building.md
 rename docs/core/{experimental_geometry.md => geometry/layerless/layerless.md} (91%)
 create mode 100644 docs/core/geometry/legacy/building.md
 create mode 100644 docs/core/geometry/legacy/layers.md
 create mode 100644 docs/core/geometry/legacy/legacy.md
 create mode 100644 docs/core/geometry/legacy/volumes.md
 create mode 100644 docs/core/geometry/material.md
 create mode 100644 docs/core/geometry/surfaces.md
 create mode 100644 docs/core/howto/index.md
 create mode 100644 docs/core/howto/material_mapping.md
 create mode 100644 docs/core/material.md
 delete mode 100644 docs/core/material.rst
 rename docs/{ => core/misc}/figures/AxisBoundaryTypes.svg (100%)
 rename docs/core/{utilities => misc}/grid_axis.md (98%)
 create mode 100644 docs/core/misc/index.md
 rename docs/core/{ => misc}/logging.md (83%)
 rename docs/{ => core/reconstruction}/figures/gsf_bethe_heitler_approx.svg (100%)
 rename docs/{ => core/reconstruction}/figures/gsf_overview.svg (100%)
 create mode 100644 docs/core/reconstruction/index.md
 rename docs/{ => core/reconstruction/pattern_recognition}/figures/seeding/3Dcoordinates.svg (100%)
 rename docs/{ => core/reconstruction/pattern_recognition}/figures/seeding/impactParameter.svg (100%)
 rename docs/{ => core/reconstruction/pattern_recognition}/figures/seeding/r-zCoordinates.svg (100%)
 rename docs/{ => core/reconstruction/pattern_recognition}/figures/seeding/tripletsFormation.svg (100%)
 rename docs/{ => core/reconstruction/pattern_recognition}/figures/seeding/x-yCoordinates.svg (100%)
 create mode 100644 docs/core/reconstruction/pattern_recognition/pattern_recognition.md
 rename docs/core/{ => reconstruction/pattern_recognition}/seeding.md (87%)
 rename docs/core/{ => reconstruction/pattern_recognition}/track_finding.md (67%)
 create mode 100644 docs/core/reconstruction/preprocessing/clustering.md
 create mode 100644 docs/core/reconstruction/preprocessing/preprocessing.md
 rename docs/core/{ => reconstruction/preprocessing}/spacepoint_formation.md (53%)
 rename docs/core/{ => reconstruction}/track_fitting.md (83%)
 create mode 100644 docs/core/reconstruction/vertexing.md
 delete mode 100644 docs/core/vertexing.md
 rename docs/core/visualization/{visualization.rst => 3d.md} (79%)
 rename docs/{figures/visualization => core/visualization/figures}/AngularError.png (100%)
 rename docs/{figures/visualization => core/visualization/figures}/CartesianError.png (100%)
 rename docs/{figures/visualization => core/visualization/figures}/CylinderLayer.png (100%)
 rename docs/{figures/visualization => core/visualization/figures}/Parameters.png (100%)
 create mode 100644 docs/core/visualization/index.md
 create mode 100644 docs/core/visualization/svg.md
 delete mode 100644 docs/examples/digizier_config.md
 rename docs/{ => examples}/howto/add_new_algorithm.md (56%)
 rename docs/examples/{ => howto}/analysis_apps.rst (98%)
 rename docs/examples/howto/{smearing_digitization_config.md => digitization_config.md} (100%)
 rename docs/{figures/examples => examples/howto/figures/analysis_apps}/aa_mc_stacked_x0.gif (100%)
 rename docs/{figures/examples => examples/howto/figures/analysis_apps}/aa_rp_layers.png (100%)
 rename docs/{figures/examples => examples/howto/figures/analysis_apps}/aa_ts_d0.png (100%)
 rename docs/{figures/examples => examples/howto/figures/analysis_apps}/aa_ts_nhits.png (100%)
 rename docs/{ => examples/howto}/figures/materialMapping/ActsMaterialMappingAutoTuning.png (100%)
 rename docs/{ => examples/howto}/figures/materialMapping/approach_layers.png (100%)
 rename docs/{ => examples/howto}/figures/materialMapping/boundaries.png (100%)
 rename docs/{ => examples/howto}/figures/materialMapping/layers_for_volume_17.png (100%)
 rename docs/{ => examples/howto}/figures/materialMapping/volumes_and_layers.png (100%)
 rename docs/{howto/run_material_mapping.rst => examples/howto/material_mapping.rst} (96%)
 delete mode 100644 docs/examples/howto/run_alignment.rst
 rename docs/{ => examples}/howto/run_ckf_auto_tuning.rst (100%)
 delete mode 100644 docs/examples/howto/run_ckf_tracking.rst
 delete mode 100644 docs/examples/howto/run_fatras.rst
 delete mode 100644 docs/examples/howto/run_seeding.rst
 delete mode 100644 docs/examples/howto/run_sycl_seed_finding.rst
 delete mode 100644 docs/examples/howto/run_truth_tracking.rst
 delete mode 100644 docs/examples/howto/setup_and_run_vertexing.md
 delete mode 100644 docs/examples/material_mapping.md
 delete mode 100755 docs/figures/CuboidVolumeBounds_decomp.gif
 delete mode 100755 docs/figures/CylinderVolumeBounds_decomp.gif
 delete mode 100755 docs/figures/DoubleTrapezoidVolumeBounds_decom.gif
 delete mode 100644 docs/figures/SubtractedPlaneBounds.gif
 delete mode 100755 docs/figures/TrapezoidVolumeBounds_decom.gif
 delete mode 100755 docs/figures/VolumeShapes.gif
 rename docs/figures/{ => doxygen}/ConeBounds.gif (100%)
 rename docs/figures/{ => doxygen}/CylinderBounds.gif (100%)
 rename docs/figures/{ => doxygen}/CylinderSurface.png (100%)
 rename docs/figures/{ => doxygen}/DiamondBounds.svg (100%)
 rename docs/figures/{ => doxygen}/DiscBounds.gif (100%)
 rename docs/figures/{ => doxygen}/DiscSurface.png (100%)
 rename docs/figures/{ => doxygen}/EllipseBounds.png (100%)
 rename docs/figures/{ => doxygen}/LineSurface.png (100%)
 rename docs/figures/{ => doxygen}/PlaneSurface.png (100%)
 rename docs/figures/{RectangularBounds.gif => doxygen/RectangleBounds.gif} (100%)
 rename docs/figures/{ => doxygen}/RotatedTrapezoidBounds.gif (100%)
 rename docs/figures/{ => doxygen}/SignOfDriftCircleD0.gif (100%)
 rename docs/figures/{ => doxygen}/TrapezoidBounds.gif (100%)
 delete mode 100644 docs/howto/howto.md
 delete mode 100644 docs/howto/material_mapping_and_validation.md
 delete mode 100644 docs/howto/produce_digitizer_config.md
 delete mode 100644 docs/howto/run_material_mapping_auto_tuning.rst
 rename docs/{ => plugins}/figures/DD4hepPlugin_DetElementStructure.jpg (100%)
 rename docs/{figures/plugins => plugins/figures}/sycl/count_duplets.png (100%)
 rename docs/{figures/plugins => plugins/figures}/sycl/duplet_search_matrix.png (100%)
 rename docs/{figures/plugins => plugins/figures}/sycl/flat_matrix.png (100%)
 rename docs/{figures/plugins => plugins/figures}/sycl/middle_duplet_indices.png (100%)
 rename docs/{figures/plugins => plugins/figures}/sycl/prefix_sum_array.png (100%)
 rename docs/{figures/plugins => plugins/figures}/tgeo/TGeoArb8_PlaneSurface.png (100%)
 rename docs/{figures/plugins => plugins/figures}/tgeo/TGeoBBox_PlaneSurface.png (100%)
 rename docs/{figures/plugins => plugins/figures}/tgeo/TGeoTrd1_PlaneSurface.png (100%)
 rename docs/{figures/plugins => plugins/figures}/tgeo/TGeoTrd2_PlaneSurface_xz.png (100%)
 rename docs/{figures/plugins => plugins/figures}/tgeo/TGeoTrd2_PlaneSurface_yz.png (100%)
 rename docs/{figures/plugins => plugins/figures}/tgeo/TGeoTube_CylinderSurface.png (100%)
 rename docs/{figures/plugins => plugins/figures}/tgeo/TGeoTube_DiscSurface.png (100%)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 8a087e2f329..d09fc3c8432 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -15,21 +15,43 @@ concurrency:
 jobs:
   docs:
     runs-on: ubuntu-latest
-    container: ghcr.io/acts-project/ubuntu2204:v41
     env:
         DOXYGEN_WARN_AS_ERROR: FAIL_ON_WARNINGS
+        DOXYGEN_VERSION: 1.9.4
     steps:
       - uses: actions/checkout@v3
+
+      - name: Cache doxygen
+        id: cache-doxygen
+        uses: actions/cache@v3
+        with:
+          path: /usr/local/bin/doxygen
+          key: doxygen_${{ env.DOXYGEN_VERSION }}
+
+      - name: Install doxygen
+        if: steps.cache-doxygen.outputs.cache-hit != 'true'
+        run: >
+          curl -SL https://sourceforge.net/projects/doxygen/files/rel-${{ env.DOXYGEN_VERSION }}/doxygen-${{ env.DOXYGEN_VERSION }}.linux.bin.tar.gz/download | tar -xzC .
+          && mv doxygen-${{ env.DOXYGEN_VERSION }}/bin/doxygen /usr/local/bin/doxygen
+
       - name: Install dependencies
         run: >
-          curl -SL https://sourceforge.net/projects/doxygen/files/rel-1.9.4/doxygen-1.9.4.linux.bin.tar.gz/download | tar -xzC .
-          && mv doxygen-1.9.4/bin/doxygen /usr/local/bin/doxygen
-          && pip3 install --upgrade pip
+          pip3 install --upgrade pip
           && pip install -r docs/requirements.txt
-      - name: Configure
-        run: cmake -B build -S . -GNinja -DACTS_BUILD_DOCS=ON
-      - name: Build
-        run: cmake --build build --target docs-with-api
+
+      - name: Build documentation
+        run: >
+          cd docs
+          && sphinx-build
+          -b html
+          -d _build/doctrees/
+          -j auto
+          -W
+          --keep-going
+          -t run_doxygen
+          -b linkcheck
+          . _build/html/
+
       - uses: actions/upload-artifact@v3
         with:
           name: acts-docs
diff --git a/Core/include/Acts/Definitions/Algebra.hpp b/Core/include/Acts/Definitions/Algebra.hpp
index b7dc446489a..a8b54653d23 100644
--- a/Core/include/Acts/Definitions/Algebra.hpp
+++ b/Core/include/Acts/Definitions/Algebra.hpp
@@ -42,7 +42,6 @@ namespace Acts {
 /// no dynamic-sized symmetric matrix type is defined. Use the
 /// `ActsDynamicMatrix` instead.
 ///
-/// @{
 
 /// Common scalar (floating point type used for the default algebra types.
 ///
@@ -67,15 +66,12 @@ using ActsDynamicVector = Eigen::Matrix<ActsScalar, Eigen::Dynamic, 1>;
 using ActsDynamicMatrix =
     Eigen::Matrix<ActsScalar, Eigen::Dynamic, Eigen::Dynamic>;
 
-/// @}
-
 /// @defgroup coordinates-types Fixed-size vector/matrix types for coordinates
 ///
 /// These predefined types should always be used when handling coordinate
 /// vectors in different coordinate systems, i.e. on surfaces (2d), spatial
 /// position (3d), or space-time (4d).
 ///
-/// @{
 
 // coordinate vectors
 using Vector2 = ActsVector<2>;
@@ -104,6 +100,4 @@ using AngleAxis3 = Eigen::AngleAxis<ActsScalar>;
 using Transform2 = Eigen::Transform<ActsScalar, 2, Eigen::AffineCompact>;
 using Transform3 = Eigen::Transform<ActsScalar, 3, Eigen::Affine>;
 
-/// @}
-
 }  // namespace Acts
diff --git a/Core/include/Acts/Propagator/AbortList.hpp b/Core/include/Acts/Propagator/AbortList.hpp
index 01e6ebb5d17..ff2814ced62 100644
--- a/Core/include/Acts/Propagator/AbortList.hpp
+++ b/Core/include/Acts/Propagator/AbortList.hpp
@@ -20,8 +20,6 @@ namespace hana = boost::hana;
 
 namespace Acts {
 
-/// @cond
-
 /// @brief AbortList object to be used in the propagation
 ///
 /// The abort list is a list of structs or classes that
@@ -39,10 +37,12 @@ struct AbortList : public detail::Extendable<aborters_t...> {
   using detail::Extendable<aborters_t...>::tuple;
 
  public:
+  /// @cond
   // This uses the type collector
   using result_type = typename decltype(hana::unpack(
       detail::type_collector_t<detail::action_type_extractor, aborters_t...>,
       hana::template_<AbortList>))::type;
+  /// @endcond
 
   using detail::Extendable<aborters_t...>::get;
 
@@ -103,6 +103,7 @@ struct AbortList : public detail::Extendable<aborters_t...> {
   /// @param [in] stepper Stepper used for the propagation
   /// @param [in] navigator Navigator used for the propagation
   /// @param [in] result is the result object from a certain action
+  /// @param [in] args are the arguments to be passed to the aborters
   template <typename propagator_state_t, typename stepper_t,
             typename navigator_t, typename result_t, typename... Args>
   bool operator()(propagator_state_t& state, const stepper_t& stepper,
@@ -114,6 +115,4 @@ struct AbortList : public detail::Extendable<aborters_t...> {
   }
 };
 
-/// @endcond
-
 }  // namespace Acts
diff --git a/Core/include/Acts/Propagator/ActionList.hpp b/Core/include/Acts/Propagator/ActionList.hpp
index 6ada9b76fb3..6118aaa66a3 100644
--- a/Core/include/Acts/Propagator/ActionList.hpp
+++ b/Core/include/Acts/Propagator/ActionList.hpp
@@ -21,8 +21,6 @@ namespace hana = boost::hana;
 
 namespace Acts {
 
-/// @cond
-
 /// @brief ActionList implementation to be used with the propagator
 ///
 /// This is the ActionList struct that is used in the propagator
@@ -37,11 +35,13 @@ struct ActionList : public detail::Extendable<actors_t...> {
   using detail::Extendable<actors_t...>::tuple;
 
  public:
+  /// @cond
   // This uses the type collector and unpacks using the `R` meta function
   template <template <typename...> class R>
   using result_type = typename decltype(hana::unpack(
       detail::type_collector_t<detail::result_type_extractor, actors_t...>,
       hana::template_<R>))::type;
+  /// @endcond
 
   using detail::Extendable<actors_t...>::get;
 
@@ -82,6 +82,7 @@ struct ActionList : public detail::Extendable<actors_t...> {
   /// @param [in] stepper The stepper in use
   /// @param [in] navigator The navigator in use
   /// @param [in,out] result This is the result object from actions
+  /// @param [in] args The arguments to be passed to the actions
   template <typename propagator_state_t, typename stepper_t,
             typename navigator_t, typename result_t, typename... Args>
   void operator()(propagator_state_t& state, const stepper_t& stepper,
@@ -93,6 +94,4 @@ struct ActionList : public detail::Extendable<actors_t...> {
   }
 };
 
-/// @endcond
-
 }  // namespace Acts
diff --git a/Core/include/Acts/Propagator/ConstrainedStep.hpp b/Core/include/Acts/Propagator/ConstrainedStep.hpp
index 49d82f2dce1..1952ca693c9 100644
--- a/Core/include/Acts/Propagator/ConstrainedStep.hpp
+++ b/Core/include/Acts/Propagator/ConstrainedStep.hpp
@@ -97,8 +97,6 @@ class ConstrainedStep {
   constexpr Scalar value(Type type) const { return m_values[type]; }
 
   /// Access the accuracy value
-  ///
-  /// @param type is the requested parameter type
   constexpr Scalar accuracy() const { return m_accuracy; }
 
   /// release a certain constraint value
@@ -107,8 +105,6 @@ class ConstrainedStep {
   constexpr void release(Type type) { m_values[type] = kNotSet; }
 
   /// release accuracy
-  ///
-  /// @param type is the constraint type to be released
   constexpr void releaseAccuracy() { m_accuracy = kNotSet; }
 
   /// Update the step size of a certain type
diff --git a/Core/include/Acts/Surfaces/ConeBounds.hpp b/Core/include/Acts/Surfaces/ConeBounds.hpp
index d4c5af07b6e..f75b679872c 100644
--- a/Core/include/Acts/Surfaces/ConeBounds.hpp
+++ b/Core/include/Acts/Surfaces/ConeBounds.hpp
@@ -31,7 +31,7 @@ namespace Acts {
 ///  The cone can open to both sides, steered by \f$ z_min \f$ and \f$ z_max
 ///  \f$.
 ///
-///  @image html figures/ConeBounds.gif
+///  @image html ConeBounds.gif
 ///
 
 class ConeBounds : public SurfaceBounds {
diff --git a/Core/include/Acts/Surfaces/CylinderBounds.hpp b/Core/include/Acts/Surfaces/CylinderBounds.hpp
index 73a2f6ad1d2..94e8098fa9d 100644
--- a/Core/include/Acts/Surfaces/CylinderBounds.hpp
+++ b/Core/include/Acts/Surfaces/CylinderBounds.hpp
@@ -24,6 +24,7 @@
 namespace Acts {
 
 /// @class CylinderBounds
+/// @image html CylinderBounds.gif
 ///
 /// Bounds for a cylindrical Surface.
 ///
diff --git a/Core/include/Acts/Surfaces/CylinderSurface.hpp b/Core/include/Acts/Surfaces/CylinderSurface.hpp
index 0c73da735d0..3e55688601b 100644
--- a/Core/include/Acts/Surfaces/CylinderSurface.hpp
+++ b/Core/include/Acts/Surfaces/CylinderSurface.hpp
@@ -38,7 +38,7 @@ class DetectorElementBase;
 /// since it builds the surfaces of all TrackingVolumes at container level
 /// for a cylindrical tracking geometry.
 ///
-/// @image html figures/CylinderSurface.png
+/// @image html CylinderSurface.png
 
 class CylinderSurface : public Surface {
 #ifndef DOXYGEN
diff --git a/Core/include/Acts/Surfaces/DiamondBounds.hpp b/Core/include/Acts/Surfaces/DiamondBounds.hpp
index b06e2f7acc6..1482e3f4931 100644
--- a/Core/include/Acts/Surfaces/DiamondBounds.hpp
+++ b/Core/include/Acts/Surfaces/DiamondBounds.hpp
@@ -26,6 +26,7 @@ namespace Acts {
 
 /// @class DiamondBounds
 ///
+/// @image html DiamondBounds.svg
 /// Bounds for a double trapezoidal ("diamond"), planar Surface.
 class DiamondBounds : public PlanarBounds {
  public:
diff --git a/Core/include/Acts/Surfaces/DiscBounds.hpp b/Core/include/Acts/Surfaces/DiscBounds.hpp
index e37ee4d19d4..cc4a8a265ee 100644
--- a/Core/include/Acts/Surfaces/DiscBounds.hpp
+++ b/Core/include/Acts/Surfaces/DiscBounds.hpp
@@ -14,6 +14,8 @@ namespace Acts {
 
 /// @class DiscBounds
 ///
+/// @image html DiscBounds.gif
+///
 /// common base class for all bounds that are in a r/phi frame
 ///  - simply introduced to avoid wrong bound assignments to surfaces
 
diff --git a/Core/include/Acts/Surfaces/DiscSurface.hpp b/Core/include/Acts/Surfaces/DiscSurface.hpp
index 75cdacd89b8..8c40d89f284 100644
--- a/Core/include/Acts/Surfaces/DiscSurface.hpp
+++ b/Core/include/Acts/Surfaces/DiscSurface.hpp
@@ -48,7 +48,7 @@ class SurfaceBounds;
 /// to happen to transfer the local coordinates onto the
 /// cartesian reference frame coordinates.
 ///
-/// @image html figures/DiscSurface.png
+/// @image html DiscSurface.png
 ///
 class DiscSurface : public Surface {
 #ifndef DOXYGEN
diff --git a/Core/include/Acts/Surfaces/EllipseBounds.hpp b/Core/include/Acts/Surfaces/EllipseBounds.hpp
index a62f5529624..ff40fbe3ee4 100644
--- a/Core/include/Acts/Surfaces/EllipseBounds.hpp
+++ b/Core/include/Acts/Surfaces/EllipseBounds.hpp
@@ -27,6 +27,8 @@ namespace Acts {
 
 /// @class EllipseBounds
 ///
+/// @image html EllipseBounds.png
+///
 /// Class to describe the bounds for a planar ellispoid
 /// surface.
 ///
diff --git a/Core/include/Acts/Surfaces/LineSurface.hpp b/Core/include/Acts/Surfaces/LineSurface.hpp
index ac460b803c4..571170b8ece 100644
--- a/Core/include/Acts/Surfaces/LineSurface.hpp
+++ b/Core/include/Acts/Surfaces/LineSurface.hpp
@@ -37,7 +37,7 @@ class SurfaceBounds;
 ///
 ///  @note It leaves the type() method virtual, so it can not be instantiated
 ///
-/// @image html figures/LineSurface.png
+/// @image html LineSurface.png
 class LineSurface : public Surface {
 #ifndef DOXYGEN
   friend Surface;
@@ -182,7 +182,7 @@ class LineSurface : public Surface {
   /// of @f$ \vec{d} @f$ on @f$ \vec{measX} @f$:<br> @f$ sign = -sign(\vec{d}
   /// \cdot \vec{measX}) @f$
   ///
-  /// @image html figures/SignOfDriftCircleD0.gif
+  /// @image html SignOfDriftCircleD0.gif
   ///
   /// @param gctx The current geometry context object, e.g. alignment
   /// @param position global 3D position - considered to be on surface but not
diff --git a/Core/include/Acts/Surfaces/PerigeeSurface.hpp b/Core/include/Acts/Surfaces/PerigeeSurface.hpp
index 78e9cb89138..cdcfdb9a7d8 100644
--- a/Core/include/Acts/Surfaces/PerigeeSurface.hpp
+++ b/Core/include/Acts/Surfaces/PerigeeSurface.hpp
@@ -26,7 +26,7 @@ namespace Acts {
 /// The Surface axis is fixed to be the z-axis of the Tracking frame.
 /// It inherits from StraingLineSurface.
 ///
-/// @image html figures/LineSurface.png
+/// @image html LineSurface.png
 class PerigeeSurface : public LineSurface {
 #ifndef DOXYGEN
   friend Surface;
diff --git a/Core/include/Acts/Surfaces/PlaneSurface.hpp b/Core/include/Acts/Surfaces/PlaneSurface.hpp
index 3d54eb32b68..819df894055 100644
--- a/Core/include/Acts/Surfaces/PlaneSurface.hpp
+++ b/Core/include/Acts/Surfaces/PlaneSurface.hpp
@@ -37,12 +37,10 @@ class SurfaceBounds;
 /// The PlaneSurface extends the Surface class with the possibility to
 /// convert local to global positions (vice versa).
 ///
-/// @image html figures/PlaneSurface.png
+/// @image html PlaneSurface.png
 ///
 class PlaneSurface : public Surface {
-#ifndef DOXYGEN
-  friend Surface;
-#endif
+  friend class Surface;
 
  protected:
   /// Copy Constructor
diff --git a/Core/include/Acts/Surfaces/RectangleBounds.hpp b/Core/include/Acts/Surfaces/RectangleBounds.hpp
index 110c66e4511..8f2db498334 100644
--- a/Core/include/Acts/Surfaces/RectangleBounds.hpp
+++ b/Core/include/Acts/Surfaces/RectangleBounds.hpp
@@ -24,6 +24,8 @@ namespace Acts {
 
 /// @class RectangleBounds
 ///
+/// @image html RectangleBounds.gif
+///
 /// Bounds for a rectangular, planar surface - it can be used to for
 /// rectangles that are symmetrically centered around (0./0.) and for
 /// generic shifted rectangles
diff --git a/Core/include/Acts/Surfaces/StrawSurface.hpp b/Core/include/Acts/Surfaces/StrawSurface.hpp
index b0052c53194..314c2637a51 100644
--- a/Core/include/Acts/Surfaces/StrawSurface.hpp
+++ b/Core/include/Acts/Surfaces/StrawSurface.hpp
@@ -29,12 +29,10 @@ class LineBounds;
 ///  Class for a StrawSurface in the TrackingGeometry
 ///  to describe dirft tube and straw like detectors.
 ///
-/// @image html figures/LineSurface.png
+/// @image html LineSurface.png
 ///
 class StrawSurface : public LineSurface {
-#ifndef DOXYGEN
-  friend Surface;
-#endif
+  friend class Surface;
 
  protected:
   /// Constructor from Transform3 and bounds
diff --git a/Core/include/Acts/Surfaces/TrapezoidBounds.hpp b/Core/include/Acts/Surfaces/TrapezoidBounds.hpp
index 4dc84b3a0ca..502caa9ad91 100644
--- a/Core/include/Acts/Surfaces/TrapezoidBounds.hpp
+++ b/Core/include/Acts/Surfaces/TrapezoidBounds.hpp
@@ -27,7 +27,7 @@ namespace Acts {
 ///
 /// Bounds for a trapezoidal, planar Surface.
 ///
-/// @image html figures/TrapezoidBounds.gif
+/// @image html TrapezoidBounds.gif
 ///
 /// @todo can be speed optimized by calculating kappa/delta and caching it
 
diff --git a/Plugins/Geant4/include/Acts/Plugins/Geant4/Geant4DetectorElement.hpp b/Plugins/Geant4/include/Acts/Plugins/Geant4/Geant4DetectorElement.hpp
index 8aae504cb5d..3a2abb295b0 100644
--- a/Plugins/Geant4/include/Acts/Plugins/Geant4/Geant4DetectorElement.hpp
+++ b/Plugins/Geant4/include/Acts/Plugins/Geant4/Geant4DetectorElement.hpp
@@ -32,9 +32,10 @@ class Geant4DetectorElement : public DetectorElementBase {
   using ContextType = GeometryContext;
 
   /// @brief  Constructor with arguments
-  /// @param thickness the thickness of this detector element
+  /// @param surface the surface representing this detector element
+  /// @param g4physVol the physical volume representing this detector element
   /// @param toGlobal the global transformation before the volume
-  /// @param g4phys the physical volume representing this detector element
+  /// @param thickness the thickness of this detector element
   Geant4DetectorElement(std::shared_ptr<Surface> surface,
                         const G4VPhysicalVolume& g4physVol,
                         const Transform3& toGlobal, ActsScalar thickness);
diff --git a/Plugins/Geant4/include/Acts/Plugins/Geant4/Geant4DetectorSurfaceFactory.hpp b/Plugins/Geant4/include/Acts/Plugins/Geant4/Geant4DetectorSurfaceFactory.hpp
index a78981143ee..1a4712462ad 100644
--- a/Plugins/Geant4/include/Acts/Plugins/Geant4/Geant4DetectorSurfaceFactory.hpp
+++ b/Plugins/Geant4/include/Acts/Plugins/Geant4/Geant4DetectorSurfaceFactory.hpp
@@ -76,16 +76,14 @@ class Geant4DetectorSurfaceFactory {
   };
 
   /// The Geant4 detector element factory
-  ///
-  /// @param cfg the configuration struct
   Geant4DetectorSurfaceFactory() = default;
 
   /// Construction method of the detector elements
   ///
   /// @param cache [in,out] into which the Elements are filled
   /// @param g4ToGlobal the transformation to global
-  /// @param g4PhyVol the current physical volume
-  /// @param options the factory creation option
+  /// @param g4PhysVol the current physical volume
+  /// @param option the factory creation option
   ///
   void construct(Cache& cache, const G4Transform3D& g4ToGlobal,
                  const G4VPhysicalVolume& g4PhysVol, const Options& option);
diff --git a/docs/CMakeLists.txt b/docs/CMakeLists.txt
index 8cfd20d5270..72664f290d5 100644
--- a/docs/CMakeLists.txt
+++ b/docs/CMakeLists.txt
@@ -3,85 +3,34 @@
 # the code. when running running on readthedocs.org, the build is fully driven
 # by Sphinx, including running Doxygen.
 #
-# this CMake-based build is only intended for local development. Doxygen is
-# run separate from Sphinx to avoid running it when no code has change. since
-# the full documentation with automatic generation of API docs take O(10mins)
-# to build, the default `docs` target does not include the API docs generation
-# but includes the Sphinx-Doxygen integration (breathe).
-#
-# the full documentation as on readthedocs.org can be build via the additional
-# `docs-with-api` target.
-#
-# WARNING: after you ran `docs-with-api` the regular `docs` target will
-#          accidentally pick up the auto-generated api files. remove the
-#          `_build` and the `api` directory manually to avoid this.
-
-# this should match the INPUT declaration in the Doxyfile
-# CONFIGURE_DEPENDS ensures that adding/removing files leads to reprocessing
-file(
-  GLOB_RECURSE doxygen_sources
-  ../Core/include/*.hpp
-  ../Fatras/include/*.hpp
-  ../Plugins/include/*.hpp)
+# this CMake-based build is only intended for local development. 
 
 set(sphinx_build ${CMAKE_CURRENT_SOURCE_DIR}/_build)
-set(doxygen_index ${CMAKE_CURRENT_SOURCE_DIR}/_build/doxygen-xml/index.xml)
 set(sphinx_doctrees ${CMAKE_CURRENT_SOURCE_DIR}/_build/doctrees)
 set(sphinx_html ${CMAKE_CURRENT_SOURCE_DIR}/_build/html)
-set(sphinx_api ${CMAKE_CURRENT_SOURCE_DIR}/api)
-
-add_custom_command(
-  OUTPUT ${doxygen_index}
-  COMMAND ${DOXYGEN_EXECUTABLE}
-  DEPENDS ${doxygen_sources} Doxyfile
-  WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
-  COMMENT "Parse source code documentation with Doxygen")
-
-# this is a debug target to diagnose issues with the Doxygen configuration
-add_custom_target(run-doxygen DEPENDS ${doxygen_index})
-
-set(api_dir ${CMAKE_CURRENT_SOURCE_DIR}/api)
-set(api_index ${api_dir}/api.rst)
 
-set(doxygen_command)
-# list(APPEND doxygen_command "${Sphinx_EXECUTABLE}")
-list(APPEND doxygen_command "-b;html")
-list(APPEND doxygen_command "-d;${sphinx_doctrees}")
-list(APPEND doxygen_command "-j;auto")
-list(APPEND doxygen_command "-W;--keep-going")
+set(sphinx_command)
+list(APPEND sphinx_command "-b;html")
+list(APPEND sphinx_command "-d;${sphinx_doctrees}")
+list(APPEND sphinx_command "-j;auto")
+list(APPEND sphinx_command "-W;--keep-going")
+list(APPEND sphinx_command "-t;run_doxygen")
 
 if(DEFINED ENV{CI})
-  list(APPEND doxygen_command "-b;linkcheck")
+  list(APPEND sphinx_command "-b;linkcheck")
 endif()
 
-list(APPEND doxygen_command "${CMAKE_CURRENT_SOURCE_DIR}")
-list(APPEND doxygen_command "${sphinx_html}")
+list(APPEND sphinx_command "${CMAKE_CURRENT_SOURCE_DIR}")
+list(APPEND sphinx_command "${sphinx_html}")
+
+message(${sphinx_command})
 
 # standard target to build the documentation without automatic API generation
 add_custom_target(
   docs
-  COMMAND ${Sphinx_EXECUTABLE} ${doxygen_command}
-  DEPENDS ${doxygen_index}
+  COMMAND ${Sphinx_EXECUTABLE} ${sphinx_command}
   WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
-  COMMENT "Build documentation WITHOUT API documentation")
-
-list(APPEND doxygen_command "-t;run_apidoc")
-
-# extended target to build the full documentation with automatic API generation
-add_custom_target(
-  docs-with-api
-  COMMAND ${Sphinx_EXECUTABLE} ${doxygen_command}
-  DEPENDS ${doxygen_index}
-  WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
-  COMMENT "Build full documentation")
-
-add_custom_target(
-  docs-clean
-  COMMAND find ${sphinx_api} -mindepth 1 -type f -and -not -name "api_stub.rst" -and -not -name "api_index.rst" -delete
-  COMMAND find ${sphinx_api} -mindepth 1 -type d -delete
-  COMMAND rm -rf ${sphinx_build}
-  COMMENT "Cleaning documentation artifacts"
-)
+  COMMENT "Build documentation")
 
 install(
   DIRECTORY ${sphinx_html}/
diff --git a/docs/Doxyfile b/docs/Doxyfile
index 04a048ff477..eb6c4ceb0dc 100644
--- a/docs/Doxyfile
+++ b/docs/Doxyfile
@@ -777,6 +777,7 @@ INPUT                  = ../Core/include \
                          ../Fatras/include \
                          ../Plugins/Autodiff/include \
                          ../Plugins/DD4hep/include \
+                         ../Plugins/Geant4/include \
                          ../Plugins/Identification/include \
                          ../Plugins/Json/include \
                          ../Plugins/Legacy/include \
@@ -879,7 +880,7 @@ EXAMPLE_RECURSIVE      = NO
 # that contain images that are to be included in the documentation (see the
 # \image command).
 
-IMAGE_PATH             = figures
+IMAGE_PATH             = figures/doxygen
 
 # The INPUT_FILTER tag can be used to specify a program that doxygen should
 # invoke to filter for each input file. Doxygen will invoke the filter program
@@ -1180,15 +1181,6 @@ HTML_COLORSTYLE_SAT    = 100
 
 HTML_COLORSTYLE_GAMMA  = 80
 
-# If the HTML_TIMESTAMP tag is set to YES then the footer of each generated HTML
-# page will contain the date and time when the page was generated. Setting this
-# to YES can help to show when doxygen was last run and thus if the
-# documentation is up to date.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-HTML_TIMESTAMP         = NO
-
 # If the HTML_DYNAMIC_SECTIONS tag is set to YES then the generated HTML
 # documentation will contain sections that can be hidden and shown after the
 # page has loaded.
@@ -1745,14 +1737,6 @@ LATEX_HIDE_INDICES     = NO
 
 LATEX_BIB_STYLE        = plain
 
-# If the LATEX_TIMESTAMP tag is set to YES then the footer of each generated
-# page will contain the date and time when the page was generated. Setting this
-# to NO can help when comparing the output of multiple runs.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_LATEX is set to YES.
-
-LATEX_TIMESTAMP        = NO
-
 #---------------------------------------------------------------------------
 # Configuration options related to the RTF output
 #---------------------------------------------------------------------------
diff --git a/docs/_extensions/lazy_autodoc.py b/docs/_extensions/lazy_autodoc.py
new file mode 100644
index 00000000000..18513bcf798
--- /dev/null
+++ b/docs/_extensions/lazy_autodoc.py
@@ -0,0 +1,179 @@
+import re
+from typing import Dict, Any, List, Tuple
+from pathlib import Path
+import os
+
+from sphinx.application import Sphinx
+
+
+__version__ = "0.1.0"
+
+
+def run() -> None:
+    doc_dir = Path(__file__).parent.parent
+    api_index_target = doc_dir / "api/api.md"
+
+    roles = [
+        "class",
+        "struct",
+        "type",
+        #  "func",
+        "enum",
+    ]
+
+    role_names = {
+        "class": "Classes",
+        "struct": "Structs",
+        "type": "Types",
+        "enum": "Enums",
+        "func": "Functions",
+    }
+
+    directives = {
+        "class": "doxygenclass",
+        "struct": "doxygenstruct",
+        "type": "doxygentypedef",
+        "func": "doxygenfunction",
+        "enum": "doxygenenum",
+    }
+
+    role_instances = {k: set() for k in roles}
+
+    role_instances["type"] |= {
+        "Acts::ActsScalar",
+        "Acts::ActsVector",
+        "Acts::ActsMatrix",
+        "Acts::ActsSquareMatrix",
+        "Acts::SquareMatrix2",
+        "Acts::SquareMatrix3",
+        "Acts::SquareMatrix4",
+        "Acts::BoundMatrix",
+        "Acts::BoundSquareMatrix",
+        "Acts::Vector2",
+        "Acts::Vector3",
+        "Acts::Vector4",
+        "Acts::BoundVector",
+        "Acts::BoundTrackParameters",
+        "Acts::Transform2",
+        "Acts::Transform3",
+        "Acts::AngleAxis3",
+        "Acts::RotationMatrix2",
+        "Acts::RotationMatrix3",
+        "Acts::Translation2",
+        "Acts::Translation3",
+        "Acts::GeometryContext",
+        "Acts::FreeVector",
+        "Acts::FreeMatrix",
+        "Acts::SurfaceVector",
+        "Acts::Intersection3D",
+        "Acts::OrientedSurface",
+        "Acts::OrientedSurfaces",
+        "Acts::BoundToFreeMatrix",
+        "Acts::FreeToBoundMatrix",
+        "Acts::FreeSquareMatrix",
+        "Acts::FreeToPathMatrix",
+    }
+
+    role_instances["struct"] |= {
+        "Acts::DenseStepperPropagatorOptions",
+        "Acts::Experimental::DetectorNavigator::State",
+        "Acts::Geant4PhysicalVolumeSelectors::AllSelector",
+        "Acts::Geant4PhysicalVolumeSelectors::NameSelector",
+    }
+
+    role_instances["class"] |= {
+        "Acts::BinningData",
+        "Acts::Direction",
+        "Acts::ConstrainedStep",
+        "Acts::IAxis",
+        "Acts::SeedFilter",
+        "Acts::BoundaryCheck",
+        "Acts::ConeVolumeBounds",
+        "Acts::CuboidVolumeBounds",
+        "Acts::CylinderVolumeBounds",
+        "Acts::CutoutCylinderVolumeBounds",
+        "Acts::GenericCuboidVolumeBounds",
+        "Acts::TrapezoidVolumeBounds",
+        "Acts::GeometryObject",
+        "Acts::TrackContainer",
+        "Acts::ConeLayer",
+        "Acts::CylinderLayer",
+        "Acts::IdentifiedDetectorElement",
+        "Acts::DiscLayer",
+        "Acts::PlaneLayer",
+        "Acts::NullBField",
+        "Acts::DiscBounds",
+        "Acts::PlanarBounds",
+        "Acts::AbstractVolume",
+        "Acts::AnnulusBounds",
+        "Acts::DiamondBounds",
+        "Acts::ConvexPolygonBounds",
+        "Acts::ConvexPolygonBoundsBase",
+        "Acts::Logging::LevelOutputDecorator",
+        "Acts::Logging::NamedOutputDecorator",
+        "Acts::Logging::ThreadOutputDecorator",
+        "Acts::Logging::TimedOutputDecorator",
+        "Acts::Logging::DefaultFilterPolicy",
+        "Acts::Logging::DefaultPrintPolicy",
+    }
+
+    role_instances["func"] = {
+        "Acts::CylinderVolumeBuilder::logger",
+        "Acts::getDefaultLogger",
+        "Acts::getDummyLogger",
+        "Acts::makeDefaultBetheHeitlerApprox",
+        "Acts::convertDD4hepDetector",
+    }
+
+    role_instances["enum"] = {
+        "Acts::BinningValue",
+        "Acts::BinningType",
+        "Acts::BinningValue",
+        "Acts::BoundIndices",
+        "Acts::FreeIndices",
+        "Acts::MagneticFieldError",
+    }
+
+    role_ex = re.compile(r"[{:](" + "|".join(roles) + r")[}:]`(.+?)`")
+
+    def process_roles(file: Path) -> List[Tuple[str, str]]:
+        text = file.read_text()
+        return [m.groups() for m in role_ex.finditer(text)]
+
+    for dirpath, _, filenames in os.walk(doc_dir):
+        dirpath = Path(dirpath)
+        for file in filenames:
+            file = dirpath / file
+            if file.suffix not in (".rst", ".md"):
+                continue
+            for role, arg in process_roles(file):
+                role_instances[role].add(arg)
+
+    # add members to their parents
+
+    api_preamble = """
+    """
+
+    with api_index_target.open("w") as fh:
+        fh.write("# API Reference\n\n")
+        fh.write(api_preamble)
+        for role, instances in sorted(role_instances.items(), key=lambda x: x[0]):
+            fh.write(f"## {role_names[role]}\n")
+            for instance in sorted(instances):
+                fh.write(
+                    f"""
+:::{{{directives[role]}}} {instance}
+:::
+"""
+                )
+            fh.write("\n")
+
+
+def setup(app: Sphinx) -> Dict[str, Any]:
+    run()
+
+    return {
+        "version": __version__,
+        "parallel_read_safe": True,
+        "parallel_write_safe": True,
+    }
diff --git a/docs/conf.py b/docs/conf.py
index ad9a975c6e5..6ee1ad7db21 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -2,10 +2,12 @@
 
 import os
 import sys
+import re
 import subprocess
 from pathlib import Path
 import shutil
 import datetime
+from typing import List, Tuple
 
 # check if we are running on readthedocs.org
 on_readthedocs = os.environ.get("READTHEDOCS", None) == "True"
@@ -22,17 +24,22 @@
 
 # -- General ------------------------------------------------------------------
 
-sys.path.insert(0, str(Path(__file__).parent))
-sys.path.insert(0, str(Path(__file__).parent / "_extensions"))
+doc_dir = Path(__file__).parent
+
+sys.path.insert(0, str(doc_dir))
+sys.path.insert(0, str(doc_dir / "_extensions"))
 
 extensions = [
     "breathe",
     "myst_parser",
     "sphinx.ext.mathjax",
+    "sphinx.ext.todo",
     "warnings_filter",
 ]
 
-warnings_filter_config = str(Path(__file__).parent / "known-warnings.txt")
+todo_include_todos = True
+
+warnings_filter_config = str(doc_dir / "known-warnings.txt")
 warnings_filter_silent = True
 
 source_suffix = {
@@ -99,40 +106,64 @@
     "undoc-members",
 )
 
+nitpicky = True
+nitpick_ignore = [
+    ("cpp:identifier", "Acts"),
+    ("cpp:identifier", "detail"),
+    ("cpp:identifier", "SIZE_MAX"),
+    ("cpp:identifier", "M_PI"),
+    ("cpp:identifier", "eSize"),
+    ("cpp:identifier", "eBoundSize"),
+    ("cpp:identifier", "eFreeSize"),
+    ("cpp:identifier", "open"),
+    ("cpp:identifier", "FreeToBoundCorrection"),
+]
+
+nitpick_ignore_regex = [
+    ("cpp:identifier", r"Eigen.*"),
+    ("cpp:identifier", r"boost.*"),
+    ("cpp:identifier", r"s_.*"),
+    ("cpp:identifier", r"detail::.*"),
+    ("cpp:identifier", ".*::Identity"),
+    ("cpp:identifier", ".*::Zero"),
+    # This blanket ignore only targets the doxygen/breathe auto-generated
+    # references. Explicit references should have specific types.
+    ("cpp:identifier", r".*"),
+]
+
 # -- Automatic API documentation ---------------------------------------------
 
 env = os.environ.copy()
 env["DOXYGEN_WARN_AS_ERROR"] = "NO"
-cwd = Path(__file__).parent
 
 if on_readthedocs or tags.has("run_doxygen"):
     # if we are running on RTD Doxygen must be run as part of the build
-    print("Executing doxygen in", cwd)
+    print("Executing doxygen in", doc_dir)
     print(
         "Doxygen version:",
         subprocess.check_output(["doxygen", "--version"], encoding="utf-8"),
     )
     sys.stdout.flush()
     subprocess.check_call(
-        ["doxygen", "Doxyfile"], stdout=subprocess.PIPE, cwd=cwd, env=env
+        ["doxygen", "Doxyfile"], stdout=subprocess.PIPE, cwd=doc_dir, env=env
     )
 
-api_index_target = cwd / "api/api.rst"
+api_index_target = doc_dir / "api/api.md"
 
-if on_readthedocs or tags.has("run_apidoc"):
-    print("Executing breathe apidoc in", cwd)
+if tags.has("run_apidoc"):
+    print("Executing breathe apidoc in", doc_dir)
     subprocess.check_call(
         [sys.executable, "-m", "breathe.apidoc", "_build/doxygen-xml", "-o", "api"],
         stdout=subprocess.DEVNULL,
-        cwd=cwd,
+        cwd=doc_dir,
         env=env,
     )
     if not api_index_target.exists():
-        shutil.copyfile(cwd / "api/api_index.rst", api_index_target)
+        shutil.copyfile(doc_dir / "api/api_index.rst", api_index_target)
     print("breathe apidoc completed")
 else:
-    if not api_index_target.exists():
-        shutil.copyfile(cwd / "api/api_stub.rst", api_index_target)
+    extensions += ["lazy_autodoc"]
+
 
 import white_papers
 
diff --git a/docs/figures/physmon/physmon_artifact.png b/docs/contribution/figures/physmon/physmon_artifact.png
similarity index 100%
rename from docs/figures/physmon/physmon_artifact.png
rename to docs/contribution/figures/physmon/physmon_artifact.png
diff --git a/docs/figures/physmon/physmon_checks.png b/docs/contribution/figures/physmon/physmon_checks.png
similarity index 100%
rename from docs/figures/physmon/physmon_checks.png
rename to docs/contribution/figures/physmon/physmon_checks.png
diff --git a/docs/figures/physmon/physmon_report.png b/docs/contribution/figures/physmon/physmon_report.png
similarity index 100%
rename from docs/figures/physmon/physmon_report.png
rename to docs/contribution/figures/physmon/physmon_report.png
diff --git a/docs/figures/physmon/physmon_run.png b/docs/contribution/figures/physmon/physmon_run.png
similarity index 100%
rename from docs/figures/physmon/physmon_run.png
rename to docs/contribution/figures/physmon/physmon_run.png
diff --git a/docs/figures/release/milestone_drop.png b/docs/contribution/figures/release/milestone_drop.png
similarity index 100%
rename from docs/figures/release/milestone_drop.png
rename to docs/contribution/figures/release/milestone_drop.png
diff --git a/docs/figures/release/milestones.png b/docs/contribution/figures/release/milestones.png
similarity index 100%
rename from docs/figures/release/milestones.png
rename to docs/contribution/figures/release/milestones.png
diff --git a/docs/figures/release/next_milestone.png b/docs/contribution/figures/release/next_milestone.png
similarity index 100%
rename from docs/figures/release/next_milestone.png
rename to docs/contribution/figures/release/next_milestone.png
diff --git a/docs/figures/release/select_all_closed.png b/docs/contribution/figures/release/select_all_closed.png
similarity index 100%
rename from docs/figures/release/select_all_closed.png
rename to docs/contribution/figures/release/select_all_closed.png
diff --git a/docs/contribution/physmon.md b/docs/contribution/physmon.md
index 13ed0dd8619..2b5b9f21741 100644
--- a/docs/contribution/physmon.md
+++ b/docs/contribution/physmon.md
@@ -20,21 +20,21 @@ this on a pull request.
 The physmon CI job attaches its results as an artifact to the CI run (also for successful runs)
 From your pull request, you need to click on the *Checks* tab at the top:
 
-:::{figure} ../figures/physmon/physmon_checks.png
+:::{figure} figures/physmon/physmon_checks.png
 :width: 150px
 :align: center
 :::
 
 From there, click on the *Builds* workflow on the left:
 
-:::{figure} ../figures/physmon/physmon_run.png
+:::{figure} figures/physmon/physmon_run.png
 :width: 300px
 :align: center
 :::
 
 On the workflow overview, scroll down to find the attached artifacts, and locate the *physmon* artifact. You can click to download it:
 
-:::{figure} ../figures/physmon/physmon_artifact.png
+:::{figure} figures/physmon/physmon_artifact.png
 :width: 100%
 :align: center
 :::
@@ -81,7 +81,7 @@ contain plots of all the histogram comparisons, and the `.html` files contain
 single-file reports showing the detailed results. An example of an HTML report
 looks like this:
 
-:::{figure} ../figures/physmon/physmon_report.png
+:::{figure} figures/physmon/physmon_report.png
 :width: 100%
 :align: center
 :::
diff --git a/docs/contribution/release.md b/docs/contribution/release.md
index bd9f2f824f1..3186eec1129 100644
--- a/docs/contribution/release.md
+++ b/docs/contribution/release.md
@@ -54,7 +54,7 @@ On push, a CI job should run and create an additional commit on the `releases` b
 
 By convention, we assign all open PRs and issues to the `next` milestone. When a new release is cut, all closed issues and PRs are moved over to a dedicated milestone named after the next version number. To do this, go to the *Pull Requests* view on the main repository, and click *Milestones*:
 
-:::{image} /figures/release/milestones.png
+:::{image} figures/release/milestones.png
 :width: 300px
 :alt: The milestones button
 :::
@@ -63,13 +63,13 @@ First, create a new milestone here. Name it `vX.Y.Z`, corresponding to the next
 
 Next, go back to the list of milestones and go to the `next` milestone, and click on *closed* to get to a list of all closed PRs and issues assigned to it:
 
-:::{image} /figures/release/next_milestone.png
+:::{image} figures/release/next_milestone.png
 :alt: The next milestone, which has a "closed" button
 :::
 
 You'll be taken to a list view which shows all closed PRs and issues assigned to the `next` milestone. On the top left there should be a checkbox allowing you to select all visible items:
 
-:::{image} /figures/release/select_all_closed.png
+:::{image} figures/release/select_all_closed.png
 :alt: Checkbox to select all visible PRs and issues.
 :width: 200px
 :::
@@ -79,7 +79,7 @@ You'll be taken to a list view which shows all closed PRs and issues assigned to
 
 Towards the right there's a button called *Milestone* which allows you to select a milestone to assign. Assign all closed items to the new milestone you created above.
 
-:::{image} /figures/release/milestone_drop.png
+:::{image} figures/release/milestone_drop.png
 :alt: Dropdown to assign the selected items to a new milestone
 :width: 300px
 :::
diff --git a/docs/core/clustering.md b/docs/core/clustering.md
deleted file mode 100644
index 4e029468e0b..00000000000
--- a/docs/core/clustering.md
+++ /dev/null
@@ -1,6 +0,0 @@
-(clustering_core)=
-# Clustering
-
-:::{note}
-This is a stub!
-:::
diff --git a/docs/core/core.rst b/docs/core/core.rst
index 9cea19466ec..089a9657972 100644
--- a/docs/core/core.rst
+++ b/docs/core/core.rst
@@ -5,22 +5,22 @@ The Acts core functionality is grouped into modules, where each module contains
 tools related to one particular subject, i.e. experiment geometry or vertexing.
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
    definitions/algebra
    definitions/units
    eventdata
-   geometry
-   experimental_geometry
-   magnetic_field
+
+   geometry/index
    material
+
    propagation
-   clustering
-   spacepoint_formation
-   seeding
-   track_fitting
-   track_finding
-   vertexing
-   utilities/grid_axis
-   logging
-   visualization/visualization
+   magnetic_field
+
+   reconstruction/index
+
+   visualization/index
+
+   misc/index
+
+   howto/index
diff --git a/docs/core/eventdata.md b/docs/core/eventdata.md
index c3fcfdfa531..f68cd55b112 100644
--- a/docs/core/eventdata.md
+++ b/docs/core/eventdata.md
@@ -1,7 +1,7 @@
 # Event data
 
 :::{attention}
-This section is largely **outdated** and will be replaced in the future.
+This section is **incomplete!**
 :::
 
 ## Track parametrization
@@ -11,105 +11,10 @@ An introduction to track parametrization concepts can be found in
 [](track_parametrization).
 :::
 
-A trajectory in a magnetic field is generally parameterized by a set of at least
-five parameters (when being bound to a surface). Two different categories are
-used in Acts: so-called bound parameters, i.e. parameter bound to a surface and
-curvilinear parameters. Curvilinear parameters are defined in an implicit planar
-and normal (to the track) reference plane that follows the track. The center of
-the implicitly defined plane is at the current track position, while the normal
-vector points along the momentum direction. Per definition the local parameters
-of a curvilinear parametrization are thus fixed to (0,0).
+### Particle hypothesis
 
-In Acts the parametrization is can be changed, provided the according
-transformations into global coordinates are given, it can be changed by adapting
-the relevant `coordinate_transformation` definition. This shows an excerpt of
-the default implementation:
+### Charge type management
 
-```cpp
-namespace Acts {
-namespace detail {
-  /**
-   * @brief helper structure summarizing coordinate transformations
-   */
-  struct coordinate_transformation
-  {
-    typedef ActsVector<ActsScalar, Acts::NGlobalPars> ParVector_t;
-
-    static Vector3
-    parameters2globalPosition(const ParVector_t& pars, const Surface& s)
-    {
-      return s.localToGlobal(Vector2(pars(Acts::eBoundLoc0), pars(Acts::eBoundLoc1)),
-                             parameters2globalMomentum(pars));
-    }
-
-    static Vector3
-    parameters2globalMomentum(const ParVector_t& pars)
-    {
-      Vector3 momentum;
-      double         p     = std::abs(1. / pars(Acts::eBoundQOverP));
-      double         phi   = pars(Acts::eBoundPhi);
-      double         theta = pars(Acts::eBoundTheta);
-      momentum << p * sin(theta) * cos(phi), p * sin(theta) * sin(phi),
-          p * cos(theta);
-
-      return momentum;
-    }
-
-    static ParVector_t
-    global2curvilinear(const Vector3&,
-                       const Vector3& mom,
-                       double                charge)
-    {
-      ParVector_t parameters;
-      parameters << 0, 0, mom.phi(), mom.theta(),
-          ((std::abs(charge) < 1e-4) ? 1. : charge) / mom.mag();
-
-      return parameters;
-    }
-  // ...
-  };
-} // end of namespace detail
-} // end of namespace Acts
-```
-
-Changing the default parameter definition and transformation needs recompilation
-of the Acts Software and redefinition of the relevant plugin:
- 
-```cmake
-target_compile_definitions (Acts::Core PUBLIC -DACTS_PARAMETER_DEFINITIONS_PLUGIN="${ACTS_PARAMETER_DEFINITIONS_PLUGIN}")
-```
-
-### Neutral and charged representations
-
-Track parameters come in a charged and neutral flavor, the flavor is defined using a template parameter,
-which either is a `ChargedPolicy` class for charged track parameter representation:
-
-```cpp
-namespace Acts {
-    typedef SingleTrackParameters<ChargedPolicy>            TrackParameters;
-    typedef GenericCurvilinearTrackParameters<ChargedPolicy> CurvilinearTrackParameters;
-    typedef GenericBoundTrackParameters<ChargedPolicy>       BoundTrackParameters;
-}  // end of namespace Acts
-```
-
-Or, respectively, a `NeutralPolicy` object
-
-```cpp
-namespace Acts {
-    typedef SingleTrackParameters<NeutralPolicy> NeutralParameters;
-    typedef GenericCurvilinearTrackParameters<NeutralPolicy>
-                                              NeutralCurvilinearTrackParameters;
-    typedef GenericBoundTrackParameters<NeutralPolicy> NeutralBoundTrackParameters;
-} // end of namespace Acts  
-```
-
-### Multi-variant representation
-
-Multi-variant fitters, such as the Gaussian Sum filter rely on a multi-component
-description of the track, which requires the definition of multi-variant track
-parameters. For Acts, as Propagator and Extrapolator are written for type
-templates, a multi-variant definition of track parametrization is *planned* in
-order to integrate directly with the core software.
 
 ## Measurements
 
@@ -119,38 +24,9 @@ the track fit, when trajectory information (or information about the trajectory
 hypothesis) is available, certain calibration steps can help to improve the
 track fit quality.
 
-### Uncalibrated measurements
-
-Measurements in a detector can be one to many-dimensional (covering the full
-range up to the full track parametrization).
-
-```cpp
-template <typename Identifier, BoundIndices... params>
-class Measurement
-{
-  // check type conditions
-  static_assert(std::is_copy_constructible<Identifier>::value,
-                "'Identifier' must be copy-constructible");
-  static_assert(std::is_move_constructible<Identifier>::value,
-                "'Identifier' must be move-constructible");
-  static_assert(std::is_copy_assignable<Identifier>::value,
-                "'Identifier' must be copy-assignable");
-  static_assert(std::is_move_assignable<Identifier>::value,
-                "'Identifier' must be move-assignable");
+### Uncalibrated measurements / source links
 
-private:
-  // private typedef's
-  typedef ParameterSet<params...>
-      ParSet_t;  ///< type of the underlying ParameterSet object
-// ...
-};
-```
-          
-In order to minimize the computational cost (and differently from the original
-ATLAS code base), the dimension of the measurement has to be fixed at compile
-time.          
 
 ### Calibrated measurements
 
-Calibrated measurements are temporary objects needed for track fitting and
-belonging to a track. *Still to be defined*
+## Tracks
diff --git a/docs/figures/bfield/field_cell.svg b/docs/core/figures/bfield/field_cell.svg
similarity index 100%
rename from docs/figures/bfield/field_cell.svg
rename to docs/core/figures/bfield/field_cell.svg
diff --git a/docs/figures/bfield/quiver.png b/docs/core/figures/bfield/quiver.png
similarity index 100%
rename from docs/figures/bfield/quiver.png
rename to docs/core/figures/bfield/quiver.png
diff --git a/docs/figures/MaterialAssignment.jpeg b/docs/core/figures/material/MaterialAssignment.jpeg
similarity index 100%
rename from docs/figures/MaterialAssignment.jpeg
rename to docs/core/figures/material/MaterialAssignment.jpeg
diff --git a/docs/figures/MaterialAveraging.jpeg b/docs/core/figures/material/MaterialAveraging.jpeg
similarity index 100%
rename from docs/figures/MaterialAveraging.jpeg
rename to docs/core/figures/material/MaterialAveraging.jpeg
diff --git a/docs/core/geometry.md b/docs/core/geometry.md
deleted file mode 100644
index 1c9b22da742..00000000000
--- a/docs/core/geometry.md
+++ /dev/null
@@ -1,354 +0,0 @@
-(geometry_impl)=
-# Geometry module
-
-The ACTS geometry model is strongly based on the ATLAS Tracking geometry. Its
-core is built on a surface-based description that make up all geometry objects
-of higher complexity. This design has been chosen as the surface objects can be
-used together with the track propagation module and thus all geometry objects
-become natively integrated into the tracking software.
-
-```{note}
-There is an ongoing rewrite of the geometry and navigation modules where logical layers will be modelled as volumes, see [](exp_geometry_impl).
-
-```
-
-## GeometryObject base class
-
-All geometry objects in Acts inherit from a virtual {class}`Acts::GeometryObject` base class.
-
-:::{doxygenclass} Acts::GeometryObject
-:::
-
-
-```{note}
-The `binningPosition(const GeometryContext& gctx, BinningValue& bVal)` method allows to define 
-a customized position of this object when being subject to ordering in some specific binnings, e.g. in a `BinnedArray` or a `SurfaceArray`.
-```
-
-This class ensures that a unique {class}`Acts::GeometryIdentifier` is assigned to every geometry
-object. 
-
-## Geometry identifier
-
-The {class}`Acts::GeometryIdentifier` is mainly used for fast identification of the type of
-the geometry object (as most of them are either extensions or containers of the
-{class}`Acts::Surface` objects) and for the identification of the geometry surfaces after
-building, e.g. for the uploading/assigning of material to the surface after
-creation. The {class}`Acts::GeometryIdentifier` uses a simple masking procedure for applying an
-identification schema.
-
-While it is used in Acts-internal applications such as material mapping, it is not employed for
-`EventData` and `Geometry` identification in an experiment setup. Instead, one should define and use the
-`Identifier` class in the latter case.
-
-:::{doxygenclass} Acts::GeometryIdentifier
----
-members: kVolumeMask,kBoundaryMask,kLayerMask,kApproachMask,kSensitiveMask,kExtraMask
----
-:::
-
-
-## Surface classes
-
-All classes which represent a thin surface in ACTS inherit from
-the common virtual base class {class}`Acts::Surface`, which defines
-the public interface of all surfaces. While the different concrete
-surface classes are defined by their respective native local
-coordinate system, the shapes on these surfaces are defined by classes
-that inherit from {class}`Acts::SurfaceBounds`, which every surface must provide.
-In case of boundless surfaces, a special {class}`Acts::InfiniteBounds` class is
-available.
-
-Each {class}`Acts::Surface` instance reports its type from {func}`Acts::Surface::type()`:
-
-:::{doxygenenum} Acts::Surface::SurfaceType
-:::
-
-
-| Surface Type          | Local Coordinates | Bound Types available                                                                       |
-|:----------------------|-------------------|:--------------------------------------------------------------------------------------------|
-| {class}`Acts::ConeSurface`         | $[r\phi, z]$         | {class}`Acts::ConeBounds`                                                                                |
-| {class}`Acts::CylinderSurface`     | $[r, \phi]$         | {class}`Acts::CylinderBounds`                                                                            |
-| {class}`Acts::DiscSurface`         | $[r, \phi]$         | {class}`Acts::RadialBounds`, {class}`Acts::DiscTrapezoidalBounds`                                                     |
-| {class}`Acts::PlaneSurface`        | $[x, y]$         | {class}`Acts::RectangleBounds`, {class}`Acts::TrapezoidalBounds`, <br>{class}`Acts::TriangleBounds`,{class}`Acts::InfiniteBounds`, <br> {class}`Acts::EllipseBounds` |
-| {class}`Acts::PerigeeSurface`,<br> {class}`Acts::StrawSurface` | $[d, z]$ | {class}`Acts::CylinderBounds`                                                                            |
-| {class}`Acts::LineSurface` | $[d_0, z_0]$ | {class}`Acts::LineBounds` |
-
-```{tip}
-In an ideal setup, the coordinate systems also define the readout
-measurement directions. In such a case, a track prediction from the
-propagation will already be in the correct frame of the measurement and
-residual or compatibility checks will not need additional coordinate
-transformations.
-```
-
-### Plane surface
-
-![PlaneBounds](/figures/geometry/PlaneBounds.png)
-
-:::{doxygenclass} Acts::PlaneSurface
----
-members: globalToLocal,localToGlobal,intersect,normal
----
-:::
-
-### Disc surface
-
-![DiscBounds](/figures/geometry/DiscBounds.png)
-
-:::{doxygenclass} Acts::DiscSurface
----
-members: globalToLocal,localToGlobal,intersect,normal
----
-:::
- 
-### Cylinder surface
-
-![CylinderBounds](/figures/geometry/CylinderBounds.png)
-
-:::{doxygenclass} Acts::CylinderSurface
----
-members: globalToLocal,localToGlobal,intersect,normal
----
-:::
-
-### Cone surface
-
-:::{doxygenclass} Acts::ConeSurface
----
-members: globalToLocal,localToGlobal,intersect,normal
----
-:::
-
-### Line surface
-
-{class}`Acts::LineSurface` is a special kind of surface that depends on a reference
-direction, typically the unit momentum direction $\vec d$ of a particle. A point in
-space is considered *on surface* if and only if it coincides with the point of
-closest approach between the direction vector $\vec d$ and the line direction
-vector $\vec z$. As such, the function {func}`Acts::LineSurface::globalToLocal`
-can fail, if the argument position and direction do not fulfill this criterion.
-It is pure-virtual, meaning that it can not be instantiated on its own.
-
-:::{doxygenclass} Acts::LineSurface
----
-members: globalToLocal,localToGlobal,intersect,normal
----
-:::
-
-#### Straw surface
-
-:::{doxygenclass} Acts::StrawSurface
----
-members: false
----
-:::
-
-#### Perigee surface
-
-:::{doxygenclass} Acts::PerigeeSurface
----
-members: false
----
-:::
-
-
-## Layer classes
-
-
-The {class}`Acts::Layer` class is an extension of the {class}`Acts::Surface` class that allows the
-definition of sub surfaces (sensitive surfaces for modules, or extra material
-surfaces).
-
-The layer can simply correspond to a 'virtual' surface in the detector
-description or represent a more complex object that may contain:
-
-* a representing surface, which is accessible via a {func}`Acts::Layer::surfaceRepresentation`
-* an array of contained surfaces, accessible via {func}`Acts::Layer::surfaceArray` method
-* approach surfaces (i.e. boundary surface of the volume occupied by the layer)
-* surface material description on any of the confined surfaces
-
-The following illustration shows an $xy$ view of a cylinder layer with planar
-detection modules:
-
-![CylinderLayer](/figures/geometry/CylinderLayer.png)
-
-Modules can be sorted onto layer using all supported binning methods described
-through the {class}`Acts::SurfaceArray` class. The binning can be adjusted to fit as well as
-possible.
-
-![DiscLayerEB](/figures/geometry/DiscLayerEB.png)
-
-The unoccupied space in a volume that contains a layer array is filled with
-objects of type {class}`Acts::NavigationLayer`, which allows that in a fully static geometry
-setup, every single point in a volume can be associated with a layer. Layer
-objects are confined together in a special {type}`Acts::LayerArray` class and can be
-contained by a {class}`Acts::TrackingVolume`.
-
-![LayerArray](/figures/geometry/LayerArray.png)
-
-
-
-## Volume classes
-
-The {class}`Acts::Volume` class is a container of
-{type}`Acts::BoundarySurface` objects, where each
-{type}`Acts::BoundarySurface` is an extension of the {class}`Acts::Surface`
-class with additional information about the attached volumes. The normal vector
-of the surface defines an *inside* (opposite w.r.t. the normal vector) and an
-*outside* (along w.r.t. the normal vector) direction. Either a single volume or
-an array of volumes can be attached to a volume.
-
-The simples volume class is just a collection of surfaces, where the
-{class}`Acts::TrackingVolume` describes a volume that can contain:
-
-* an array of contained layers
-* an array of contained volumes (as a container volume)
-* an array of contained volumes (as *floating* objects)
-* a volume based material description
-
-The shape of the volume is defined by {class}`Acts::VolumeBounds` classes that create the
-corresponding bounding surfaces and register the attachment to the volume itself
-at creation.
-
-![VolumeBounds](/figures/geometry/VolumeBounds.png)
-![CylinderVolumeBounds](/figures/geometry/CylinderVolumeBounds.png)
-
-## Detector material description
-
-Two types of material description exist, one for a surface based material, one
-for a volume based material. They will be dealt with differently in the
-extrapolation.
-
-The basic information for any material is:
-
-* the radiation length X0 the nuclear interaction length L0 the atomic weight A
-* the atomic charge Z the density of the material
-
-This information is confined together in the {class}`Acts::Material` class.
-
-```{note}
-In track reconstruction, only an effective material description is needed, i.e.
-non-physical values in regards of the atomic number, the elementary charge or
-even the density are allowed, as long as the effective relative radiation
-length and $A/Z \times \rho$ ratio can be retrieved.  This enables the compactification
-of the material description, as the element composition record does not have to
-be kept.
-```
-
-Surface based material extends this material information by a representative
-thickness; the corresponding object is called {class}`Acts::MaterialSlab`. The
-thickness hereby can be arbitrarily chosen in order to regulate the material
-budget, it does not have to represent the actual thickness of a detector
-element. To attach it to a surface, a dedicated {class}`Acts::SurfaceMaterial`
-class (or it's extensions) is used, which allows to also describe binned
-material.
-
-Possible extensions are:
-
- * {class}`Acts::HomogeneousSurfaceMaterial`, homogeneous material description on a surface
- * {class}`Acts::BinnedSurfaceMaterial`, an arbitrarily binned material description with a
-    corresponding {class}`Acts::BinUtility` object
-
-In addition, a dedicated extension exists to allow configuration of the material
-mapping process, that is in further described below.
-
- * {class}`Acts::ProtoSurfaceMaterial`, only binning description (without material) to be
-   used in the material mapping process
-
-## Geometry building
-
-The geometry building procedure follows the ATLAS tracking geometry philosophy of
-a static frame of *glued* volumes, that lead the navigation flow through the
-geometry,
-
-### Attaching a 3D detector geometry
-
-Usually, a 3D detector model geometry exists, which is either native to the full
-detector simulation (Geant4) or is translated into it. This model, however, is
-in general too detailed for track reconstruction: navigating through the
-detailed detector geometry is generally costly and one can profit greatly from a simplification mechanism.
-
-For most part of the track reconstruction, only a surface based description of
-the detector is needed, in order to allow (surface based) material integration
-and parametrization/prediction of trajectories on detection surfaces. It is thus
-necessary that the detection surfaces are described to full detail in the
-reconstruction geometry (called {class}`Acts::TrackingGeometry`). This is guaranteed by a
-proxy mechanism that connects the detection elements (conveniently called
-{class}`Acts::DetectorElement`) to {class}`Acts::Surface` object in the reconstruction:
-
-![DetectorElement](/figures/geometry/DetectorElement.png)
-
-#### Existing plugins for 3D geometry libraries
-
-Very simple helper methods for 3D libraries exist, they are certainly not
-optimised, but used for templating:
-
-* {class}`Acts::TGeoDetectorElement` connects a TGeo volume to a {class}`Acts::Surface`
-* {class}`Acts::DD4HepDetectorElement` connects a DD4hep volume (based on TGeo) to a {class}`Acts::Surface`
-* {class}`Acts::Geant4DetectorElement` connects a Geant4 volume to a {class}`Acts::Surface`
-
-Further extensions exist in dedicated experiment contexts, such as e.g. a `GeoModel`
-binding for the ATLAS experiment.
-
-```{note}
-While `DD4hep` offers a descriptive language with a dedicated extension mechanism
-that can be used by Acts to interpret the underlying geometry hierarchy and and structure,
-there is no such guarantee when having the already as built `TGeo` geometry in hand.
-Therefore a dedicated Acts configuration file based on `json` can be provided that allows
-to specify parsing restrictions for sub detectors. 
-```
-
-
-### Layer building
-
-{class}`Acts::Surface` objects that are to be grouped on a layer should be put into a
-{class}`Acts::SurfaceArray` and provided to the layer. Certain helper tools exist to ease the
-translation and create appropriate binning structure: The {class}`Acts::SurfaceArrayCreator`
-can create cylindrical, disc-like & planar layers, where the dimensions of the
-layer are determined by parsing the provided surfaces. Additionally, an envelope
-covering the surfaces can be chosen.
-
-```{note}
-There exist standard layer builders that are designed to build cylindrical, disk like 
-and planar layers and perform the ordering of the surfaces onto those layers. These
-builders are called from the top level translation entry points from either `TGeo` 
-or `DD4hep`.
-```
-
-
-### Volume building, packing, and gluing
-
-The philosophy of the {class}`Acts::TrackingGeometry` is a fully connective geometry setup,
-i.e. {class}`Acts::TrackingVolume` objects are either pure containers for other contained
-{class}`Acts::TrackingVolume` instances (where the contained volumes fully fill the space of
-the container volume), or are fully attached via the boundary surface mechanism.
-The boundary surfaces then act as portals from one {class}`Acts::TrackingVolume` into the
-next one along the trajectory.
-
-The process to create a fully connected tracking geometry is called glueing.
-Wherever possible, common boundary surfaces are *shared*, where this is not
-possible, they are *attached*.
-
-![GlueingBC](/figures/geometry/GlueingBC.png)
-![GlueingABC](/figures/geometry/GlueingABC.png)
-![NavigationABC](/figures/geometry/NavigationABC.png)
-
-For cylindrical detector setups, a dedicated {class}`Acts::CylinderVolumeBuilder` is
-provided, which performs a variety of volume building, packing and gluing.
-
-```{note}
-For most cylindrical detectors, there exist automated glueing and geometry building 
-modules that take care of the glueing process.
-```
-
-## TrackingGeometry building using a KDTree and a Proto Description
-
-For cylindrical detectors there exist a generic tracking geometry building module,
-based on KDTree and a proto description.
-
-This building procedure uses a {class}`Acts::ProtoDetector` description which provides a 
-high level description of layers and container volumes, together with some 
-binning and ordering information.
-This proto description is then used to assign surfaces that are provided to the 
-{class}`Acts::KDTreeTrackingGeometryBuilder` using an internal query to the KD-tree structure.
diff --git a/docs/figures/geometry/CylinderBounds.png b/docs/core/geometry/figures/CylinderBounds.png
similarity index 100%
rename from docs/figures/geometry/CylinderBounds.png
rename to docs/core/geometry/figures/CylinderBounds.png
diff --git a/docs/figures/geometry/CylinderLayer.png b/docs/core/geometry/figures/CylinderLayer.png
similarity index 100%
rename from docs/figures/geometry/CylinderLayer.png
rename to docs/core/geometry/figures/CylinderLayer.png
diff --git a/docs/figures/geometry/CylinderVolumeBounds.png b/docs/core/geometry/figures/CylinderVolumeBounds.png
similarity index 100%
rename from docs/figures/geometry/CylinderVolumeBounds.png
rename to docs/core/geometry/figures/CylinderVolumeBounds.png
diff --git a/docs/figures/geometry/DetectorElement.png b/docs/core/geometry/figures/DetectorElement.png
similarity index 100%
rename from docs/figures/geometry/DetectorElement.png
rename to docs/core/geometry/figures/DetectorElement.png
diff --git a/docs/figures/geometry/DirectPortal.png b/docs/core/geometry/figures/DirectPortal.png
similarity index 100%
rename from docs/figures/geometry/DirectPortal.png
rename to docs/core/geometry/figures/DirectPortal.png
diff --git a/docs/figures/geometry/DiscBounds.png b/docs/core/geometry/figures/DiscBounds.png
similarity index 100%
rename from docs/figures/geometry/DiscBounds.png
rename to docs/core/geometry/figures/DiscBounds.png
diff --git a/docs/figures/geometry/DiscLayerAB.png b/docs/core/geometry/figures/DiscLayerAB.png
similarity index 100%
rename from docs/figures/geometry/DiscLayerAB.png
rename to docs/core/geometry/figures/DiscLayerAB.png
diff --git a/docs/figures/geometry/DiscLayerEB.png b/docs/core/geometry/figures/DiscLayerEB.png
similarity index 100%
rename from docs/figures/geometry/DiscLayerEB.png
rename to docs/core/geometry/figures/DiscLayerEB.png
diff --git a/docs/figures/geometry/EndcapGrid.png b/docs/core/geometry/figures/EndcapGrid.png
similarity index 100%
rename from docs/figures/geometry/EndcapGrid.png
rename to docs/core/geometry/figures/EndcapGrid.png
diff --git a/docs/figures/geometry/GlueingABC.png b/docs/core/geometry/figures/GlueingABC.png
similarity index 100%
rename from docs/figures/geometry/GlueingABC.png
rename to docs/core/geometry/figures/GlueingABC.png
diff --git a/docs/figures/geometry/GlueingBC.png b/docs/core/geometry/figures/GlueingBC.png
similarity index 100%
rename from docs/figures/geometry/GlueingBC.png
rename to docs/core/geometry/figures/GlueingBC.png
diff --git a/docs/figures/geometry/LayerArray.png b/docs/core/geometry/figures/LayerArray.png
similarity index 100%
rename from docs/figures/geometry/LayerArray.png
rename to docs/core/geometry/figures/LayerArray.png
diff --git a/docs/figures/geometry/NavigationABC.png b/docs/core/geometry/figures/NavigationABC.png
similarity index 100%
rename from docs/figures/geometry/NavigationABC.png
rename to docs/core/geometry/figures/NavigationABC.png
diff --git a/docs/figures/geometry/ODD_Detector.png b/docs/core/geometry/figures/ODD_Detector.png
similarity index 100%
rename from docs/figures/geometry/ODD_Detector.png
rename to docs/core/geometry/figures/ODD_Detector.png
diff --git a/docs/figures/geometry/PlaneBounds.png b/docs/core/geometry/figures/PlaneBounds.png
similarity index 100%
rename from docs/figures/geometry/PlaneBounds.png
rename to docs/core/geometry/figures/PlaneBounds.png
diff --git a/docs/figures/geometry/SharedPortal.png b/docs/core/geometry/figures/SharedPortal.png
similarity index 100%
rename from docs/figures/geometry/SharedPortal.png
rename to docs/core/geometry/figures/SharedPortal.png
diff --git a/docs/figures/geometry/VolumeBounds.png b/docs/core/geometry/figures/VolumeBounds.png
similarity index 100%
rename from docs/figures/geometry/VolumeBounds.png
rename to docs/core/geometry/figures/VolumeBounds.png
diff --git a/docs/core/geometry/geometry_id.md b/docs/core/geometry/geometry_id.md
new file mode 100644
index 00000000000..2d7bf03d8d7
--- /dev/null
+++ b/docs/core/geometry/geometry_id.md
@@ -0,0 +1,19 @@
+# Geometry identifier
+
+The {class}`Acts::GeometryIdentifier` is mainly used for fast identification of the type of
+the geometry object (as most of them are either extensions or containers of the
+{class}`Acts::Surface` objects) and for the identification of the geometry surfaces after
+building, e.g. for the uploading/assigning of material to the surface after
+creation. The {class}`Acts::GeometryIdentifier` uses a simple masking procedure for applying an
+identification schema.
+
+While it is used in Acts-internal applications such as material mapping, it is not employed for
+`EventData` and `Geometry` identification in an experiment setup. Instead, one should define and use the
+`Identifier` class in the latter case.
+
+:::{doxygenclass} Acts::GeometryIdentifier
+---
+members: kVolumeMask,kBoundaryMask,kLayerMask,kApproachMask,kSensitiveMask,kExtraMask
+---
+:::
+
diff --git a/docs/core/geometry/index.md b/docs/core/geometry/index.md
new file mode 100644
index 00000000000..ce04855c889
--- /dev/null
+++ b/docs/core/geometry/index.md
@@ -0,0 +1,24 @@
+(geometry_impl)=
+# Geometry module
+
+The ACTS geometry model is strongly based on the ATLAS Tracking geometry. Its
+core is built on a surface-based description that make up all geometry objects
+of higher complexity. This design has been chosen as the surface objects can be
+used together with the track propagation module and thus all geometry objects
+become natively integrated into the tracking software.
+
+```{note}
+There is an ongoing rewrite of the geometry and navigation modules where
+logical layers will be modelled as volumes, see [](layerless_geometry).
+
+```
+
+:::{toctree}
+:maxdepth: 1
+geometry_id
+material
+surfaces
+legacy/legacy
+layerless/layerless
+:::
+
diff --git a/docs/core/geometry/layerless/building.md b/docs/core/geometry/layerless/building.md
new file mode 100644
index 00000000000..907a5ba9bc6
--- /dev/null
+++ b/docs/core/geometry/layerless/building.md
@@ -0,0 +1,18 @@
+# Tracking geometry building
+
+## TrackingGeometry building using a KDTree and a Proto Description
+
+For cylindrical detectors there exist a generic tracking geometry building module,
+based on KDTree and a proto description.
+
+This building procedure uses a {struct}`Acts::ProtoDetector` description which provides a 
+high level description of layers and container volumes, together with some 
+binning and ordering information.
+This proto description is then used to assign surfaces that are provided to the 
+{class}`Acts::KDTreeTrackingGeometryBuilder` using an internal query to the KD-tree structure.
+
+## Blueprint tree mechanism to build a tracking geometry
+
+:::{todo}
+Add description of Blueprint tree and how it can be used to create layerless detector.
+:::
diff --git a/docs/core/experimental_geometry.md b/docs/core/geometry/layerless/layerless.md
similarity index 91%
rename from docs/core/experimental_geometry.md
rename to docs/core/geometry/layerless/layerless.md
index be0bd5f4d9e..68f243a0eeb 100644
--- a/docs/core/experimental_geometry.md
+++ b/docs/core/geometry/layerless/layerless.md
@@ -1,6 +1,16 @@
-(exp_geometry_impl)=
+(layerless_geometry)=
+# Layerless geometry
 
-# Experimental Geometry module
+## Geometry module rosetta stone
+
+:::{todo}
+Describe replacements of `TrackingGeometry`, `TrackingVolume` etc and how the classes map to one another.
+:::
+
+
+:::{toctree}
+building
+:::
 
 :::{note}
 This module is not considered production-ready yet, and is under the namespace
@@ -27,7 +37,7 @@ While objects may be stored as `std::shared_ptr<T>` internally, their access dur
 
 ### Navigation state and delegates
 
-A struct {class}`Acts::Experimental::NavigationState` holds the current navigation information through the geometry, which comprises of
+A struct {struct}`Acts::Experimental::NavigationState` holds the current navigation information through the geometry, which comprises of
 
 - the current {class}`Acts::Experimental::DetectorVolume` in associated with the position within the detector, called `currentVolume`
 - a list of portal candidates to leave the `currentVolume`
@@ -48,13 +58,13 @@ Portals are composite objects of a {class}`Acts::Surface` object and additional
 
 When volumes are attached or glued to another, the portal object is usually shared between the volumes, and eventually portals can even be of larger extent than the actual volume they are bounding.
 
-:::{figure} /figures/geometry/DirectPortal.png
+:::{figure} ../figures/DirectPortal.png
 :width: 600px
 :align: center
 Illustration of a shared direct portal between two volumes, the arrows indicate the direction of attachment.
 :::
 
-:::{figure} /figures/geometry/SharedPortal.png
+:::{figure} ../figures/SharedPortal.png
 :width: 600px
 :align: center
 Illustration of a shared extended portal between several volumes, the arrows indicate the direction of attachment.
@@ -82,7 +92,7 @@ Additionally, it can contain:
 
 In case the volume contains surfaces and/or volumes, an adequate navigation state updator is to be provided that can resolve surface candidates or portal candidates into the sub volumes. E.g.~if the volume contain a layer with sensitive surfaces, a grid can be used to associate an entry/global position with the candidate surfaces further tested in the navigation.
 
-:::{figure} /figures/geometry/EndcapGrid.png
+:::{figure} ../figures/EndcapGrid.png
 :width: 600px
 :align: center
 Illustration of a planar module andcap detector with a grid holding the indices to the candidate surfaces.
@@ -104,7 +114,7 @@ The detector object is the holder class of all geometry objects, it has to conta
 When the detector is constructed, name duplicates are checked for and if found a `std::exception` is thrown. Similarly, when sensitive surfaces are provided and duplicate `Acts::GeometryIdentifier` objects are found during detector construction a `std::exception` is thrown. The latter can be avoided by using an appropriate (set of) `Acts::GeometyIdGenerator` tool(s) which will guarantee some level of uniqueness.
 :::
 
-:::{figure} /figures/geometry/ODD_Detector.png
+:::{figure} ../figures/ODD_Detector.png
 :width: 600px
 :align: center
 Illustration (r/z view) of the OpenDataDetector with its sub volumes, portals and contained surfaces.
diff --git a/docs/core/geometry/legacy/building.md b/docs/core/geometry/legacy/building.md
new file mode 100644
index 00000000000..2eef564a0ee
--- /dev/null
+++ b/docs/core/geometry/legacy/building.md
@@ -0,0 +1,86 @@
+# Geometry building
+
+The geometry building procedure follows the ATLAS tracking geometry philosophy of
+a static frame of *glued* volumes, that lead the navigation flow through the
+geometry,
+
+## Attaching a 3D detector geometry
+
+Usually, a 3D detector model geometry exists, which is either native to the full
+detector simulation (Geant4) or is translated into it. This model, however, is
+in general too detailed for track reconstruction: navigating through the
+detailed detector geometry is generally costly and one can profit greatly from a simplification mechanism.
+
+For most part of the track reconstruction, only a surface based description of
+the detector is needed, in order to allow (surface based) material integration
+and parametrization/prediction of trajectories on detection surfaces. It is thus
+necessary that the detection surfaces are described to full detail in the
+reconstruction geometry (called {class}`Acts::TrackingGeometry`). This is guaranteed by a
+proxy mechanism that connects the detection elements (conveniently called
+{class}`Acts::DetectorElementBase`) to {class}`Acts::Surface` object in the reconstruction:
+
+![DetectorElement](../figures/DetectorElement.png)
+
+### Existing plugins for 3D geometry libraries
+
+Very simple helper methods for 3D libraries exist, they are certainly not
+optimised, but used for templating:
+
+* {class}`Acts::TGeoDetectorElement` connects a TGeo volume to a {class}`Acts::Surface`
+* {class}`Acts::DD4hepDetectorElement` connects a DD4hep volume (based on TGeo) to a {class}`Acts::Surface`
+* {class}`Acts::Geant4DetectorElement` connects a Geant4 volume to a {class}`Acts::Surface`
+
+Further extensions exist in dedicated experiment contexts, such as e.g. a `GeoModel`
+binding for the ATLAS experiment.
+
+```{note}
+While `DD4hep` offers a descriptive language with a dedicated extension mechanism
+that can be used by Acts to interpret the underlying geometry hierarchy and and structure,
+there is no such guarantee when having the already as built `TGeo` geometry in hand.
+Therefore a dedicated Acts configuration file based on `json` can be provided that allows
+to specify parsing restrictions for sub detectors. 
+```
+
+
+## Layer building
+
+{class}`Acts::Surface` objects that are to be grouped on a layer should be put into a
+{class}`Acts::SurfaceArray` and provided to the layer. Certain helper tools exist to ease the
+translation and create appropriate binning structure: The {class}`Acts::SurfaceArrayCreator`
+can create cylindrical, disc-like & planar layers, where the dimensions of the
+layer are determined by parsing the provided surfaces. Additionally, an envelope
+covering the surfaces can be chosen.
+
+```{note}
+There exist standard layer builders that are designed to build cylindrical, disk like 
+and planar layers and perform the ordering of the surfaces onto those layers. These
+builders are called from the top level translation entry points from either `TGeo` 
+or `DD4hep`.
+```
+
+
+## Volume building, packing, and gluing
+
+The philosophy of the {class}`Acts::TrackingGeometry` is a fully connective geometry setup,
+i.e. {class}`Acts::TrackingVolume` objects are either pure containers for other contained
+{class}`Acts::TrackingVolume` instances (where the contained volumes fully fill the space of
+the container volume), or are fully attached via the boundary surface mechanism.
+The boundary surfaces then act as portals from one {class}`Acts::TrackingVolume` into the
+next one along the trajectory.
+
+The process to create a fully connected tracking geometry is called glueing.
+Wherever possible, common boundary surfaces are *shared*, where this is not
+possible, they are *attached*.
+
+![GlueingBC](../figures/GlueingBC.png)
+![GlueingABC](../figures/GlueingABC.png)
+![NavigationABC](../figures/NavigationABC.png)
+
+For cylindrical detector setups, a dedicated {class}`Acts::CylinderVolumeBuilder` is
+provided, which performs a variety of volume building, packing and gluing.
+
+```{note}
+For most cylindrical detectors, there exist automated glueing and geometry building 
+modules that take care of the glueing process.
+```
+
diff --git a/docs/core/geometry/legacy/layers.md b/docs/core/geometry/legacy/layers.md
new file mode 100644
index 00000000000..5f55092c6ab
--- /dev/null
+++ b/docs/core/geometry/legacy/layers.md
@@ -0,0 +1,34 @@
+# Layer classes
+
+The {class}`Acts::Layer` class is an extension of the {class}`Acts::Surface` class that allows the
+definition of sub surfaces (sensitive surfaces for modules, or extra material
+surfaces).
+
+The layer can simply correspond to a 'virtual' surface in the detector
+description or represent a more complex object that may contain:
+
+* a representing surface, which is accessible via a {func}`Acts::Layer::surfaceRepresentation`
+* an array of contained surfaces, accessible via {func}`Acts::Layer::surfaceArray` method
+* approach surfaces (i.e. boundary surface of the volume occupied by the layer)
+* surface material description on any of the confined surfaces
+
+The following illustration shows an $xy$ view of a cylinder layer with planar
+detection modules:
+
+![CylinderLayer](../figures/CylinderLayer.png)
+
+Modules can be sorted onto layer using all supported binning methods described
+through the {class}`Acts::SurfaceArray` class. The binning can be adjusted to fit as well as
+possible.
+
+![DiscLayerEB](../figures/DiscLayerEB.png)
+
+The unoccupied space in a volume that contains a layer array is filled with
+objects of type {class}`Acts::NavigationLayer`, which allows that in a fully static geometry
+setup, every single point in a volume can be associated with a layer. Layer
+objects are confined together in a special {type}`Acts::LayerArray` class and can be
+contained by a {class}`Acts::TrackingVolume`.
+
+![LayerArray](../figures/LayerArray.png)
+
+
diff --git a/docs/core/geometry/legacy/legacy.md b/docs/core/geometry/legacy/legacy.md
new file mode 100644
index 00000000000..17e2f428cbe
--- /dev/null
+++ b/docs/core/geometry/legacy/legacy.md
@@ -0,0 +1,14 @@
+(legacy_geometry)=
+# Legacy geometry module
+
+
+:::{todo} 
+Describe how the legacy geometry used to work and how it differs from the
+[layerless geometry](#layerless_geometry)
+:::
+
+:::{toctree}
+layers
+volumes
+building
+:::
diff --git a/docs/core/geometry/legacy/volumes.md b/docs/core/geometry/legacy/volumes.md
new file mode 100644
index 00000000000..ca49ef18177
--- /dev/null
+++ b/docs/core/geometry/legacy/volumes.md
@@ -0,0 +1,24 @@
+# Volume classes
+
+The {class}`Acts::Volume` class is a container of
+{type}`Acts::BoundarySurface` objects, where each
+{type}`Acts::BoundarySurface` is an extension of the {class}`Acts::Surface`
+class with additional information about the attached volumes. The normal vector
+of the surface defines an *inside* (opposite w.r.t. the normal vector) and an
+*outside* (along w.r.t. the normal vector) direction. Either a single volume or
+an array of volumes can be attached to a volume.
+
+The simples volume class is just a collection of surfaces, where the
+{class}`Acts::TrackingVolume` describes a volume that can contain:
+
+* an array of contained layers
+* an array of contained volumes (as a container volume)
+* an array of contained volumes (as *floating* objects)
+* a volume based material description
+
+The shape of the volume is defined by {class}`Acts::VolumeBounds` classes that create the
+corresponding bounding surfaces and register the attachment to the volume itself
+at creation.
+
+![VolumeBounds](../figures/VolumeBounds.png)
+![CylinderVolumeBounds](../figures/CylinderVolumeBounds.png)
diff --git a/docs/core/geometry/material.md b/docs/core/geometry/material.md
new file mode 100644
index 00000000000..5eef7950142
--- /dev/null
+++ b/docs/core/geometry/material.md
@@ -0,0 +1,42 @@
+# Detector material description
+
+Two types of material description exist, one for a surface based material, one
+for a volume based material. They will be dealt with differently in the
+extrapolation.
+
+The basic information for any material is:
+
+* the radiation length X0 the nuclear interaction length L0 the atomic weight A
+* the atomic charge Z the density of the material
+
+This information is confined together in the {class}`Acts::Material` class.
+
+```{note}
+In track reconstruction, only an effective material description is needed, i.e.
+non-physical values in regards of the atomic number, the elementary charge or
+even the density are allowed, as long as the effective relative radiation
+length and $A/Z \times \rho$ ratio can be retrieved.  This enables the compactification
+of the material description, as the element composition record does not have to
+be kept.
+```
+
+Surface based material extends this material information by a representative
+thickness; the corresponding object is called {class}`Acts::MaterialSlab`. The
+thickness hereby can be arbitrarily chosen in order to regulate the material
+budget, it does not have to represent the actual thickness of a detector
+element. To attach it to a surface, a dedicated {class}`Acts::ISurfaceMaterial`
+class (or it's extensions) is used, which allows to also describe binned
+material.
+
+Possible extensions are:
+
+ * {class}`Acts::HomogeneousSurfaceMaterial`, homogeneous material description on a surface
+ * {class}`Acts::BinnedSurfaceMaterial`, an arbitrarily binned material description with a
+    corresponding {class}`Acts::BinUtility` object
+
+In addition, a dedicated extension exists to allow configuration of the material
+mapping process, that is in further described below.
+
+ * {class}`Acts::ProtoSurfaceMaterial`, only binning description (without material) to be
+   used in the material mapping process
+
diff --git a/docs/core/geometry/surfaces.md b/docs/core/geometry/surfaces.md
new file mode 100644
index 00000000000..3908300a097
--- /dev/null
+++ b/docs/core/geometry/surfaces.md
@@ -0,0 +1,111 @@
+# Surface classes
+
+All classes which represent a thin surface in ACTS inherit from
+the common virtual base class {class}`Acts::Surface`, which defines
+the public interface of all surfaces. While the different concrete
+surface classes are defined by their respective native local
+coordinate system, the shapes on these surfaces are defined by classes
+that inherit from {class}`Acts::SurfaceBounds`, which every surface must provide.
+In case of boundless surfaces, a special {class}`Acts::InfiniteBounds` class is
+available.
+
+
+
+Each {class}`Acts::Surface` instance reports its type from {func}`Acts::Surface::type()`:
+
+:::{doxygenenum} Acts::Surface::SurfaceType
+:::
+
+
+| Surface Type          | Local Coordinates | Bound Types available                                                                       |
+|:----------------------|-------------------|:--------------------------------------------------------------------------------------------|
+| {class}`Acts::ConeSurface`         | $[r\phi, z]$         | {class}`Acts::ConeBounds`                                                                                |
+| {class}`Acts::CylinderSurface`     | $[r, \phi]$         | {class}`Acts::CylinderBounds`                                                                            |
+| {class}`Acts::DiscSurface`         | $[r, \phi]$         | {class}`Acts::RadialBounds`, {class}`Acts::DiscTrapezoidBounds`                                                     |
+| {class}`Acts::PlaneSurface`        | $[x, y]$         | {class}`Acts::RectangleBounds`, {class}`Acts::TrapezoidBounds`, <br>{class}`Acts::InfiniteBounds`, {class}`Acts::EllipseBounds` |
+| {class}`Acts::PerigeeSurface`,<br> {class}`Acts::StrawSurface` | $[d, z]$ | {class}`Acts::CylinderBounds`                                                                            |
+| {class}`Acts::LineSurface` | $[d_0, z_0]$ | {class}`Acts::LineBounds` |
+
+```{tip}
+In an ideal setup, the coordinate systems also define the readout
+measurement directions. In such a case, a track prediction from the
+propagation will already be in the correct frame of the measurement and
+residual or compatibility checks will not need additional coordinate
+transformations.
+```
+
+## Plane surface
+
+![PlaneBounds](figures/PlaneBounds.png)
+
+:::{doxygenclass} Acts::PlaneSurface
+---
+members: globalToLocal,localToGlobal,intersect,normal
+---
+:::
+
+## Disc surface
+
+![DiscBounds](figures/DiscBounds.png)
+
+:::{doxygenclass} Acts::DiscSurface
+---
+members: globalToLocal,localToGlobal,intersect,normal
+---
+:::
+ 
+## Cylinder surface
+
+![CylinderBounds](figures/CylinderBounds.png)
+
+:::{doxygenclass} Acts::CylinderSurface
+---
+members: globalToLocal,localToGlobal,intersect,normal
+---
+:::
+
+## Cone surface
+
+:::{doxygenclass} Acts::ConeSurface
+---
+members: globalToLocal,localToGlobal,intersect,normal
+---
+:::
+
+## Line surface
+
+{class}`Acts::LineSurface` is a special kind of surface that depends on a reference
+direction, typically the unit momentum direction $\vec d$ of a particle. A point in
+space is considered *on surface* if and only if it coincides with the point of
+closest approach between the direction vector $\vec d$ and the line direction
+vector $\vec z$. As such, the function {func}`Acts::LineSurface::globalToLocal`
+can fail, if the argument position and direction do not fulfill this criterion.
+It is pure-virtual, meaning that it can not be instantiated on its own.
+
+:::{doxygenclass} Acts::LineSurface
+---
+members: globalToLocal,localToGlobal,intersect,normal
+---
+:::
+
+### Straw surface
+
+:::{doxygenclass} Acts::StrawSurface
+---
+members: false
+---
+:::
+
+### Perigee surface
+
+:::{doxygenclass} Acts::PerigeeSurface
+---
+members: false
+---
+:::
+
+
+## API listings
+
+:::{doxygenclass} Acts::Surface
+:::
diff --git a/docs/core/howto/index.md b/docs/core/howto/index.md
new file mode 100644
index 00000000000..8304466d7b5
--- /dev/null
+++ b/docs/core/howto/index.md
@@ -0,0 +1,6 @@
+# How-to guides for Core components
+
+:::{toctree}
+:maxdepth: 1
+material_mapping
+:::
diff --git a/docs/core/howto/material_mapping.md b/docs/core/howto/material_mapping.md
new file mode 100644
index 00000000000..74bf0ca9eef
--- /dev/null
+++ b/docs/core/howto/material_mapping.md
@@ -0,0 +1,8 @@
+(material_mapping_howto_core)=
+# Material mapping
+
+:::{todo}
+Write documentation on material mapping with **Core** components!
+This is separate from the documentation on how to run the material
+mapping using the Examples framework, which is documented [here](#material_mapping_howto_examples).
+:::
diff --git a/docs/core/magnetic_field.md b/docs/core/magnetic_field.md
index 3d5f6577518..1dc4e515cba 100644
--- a/docs/core/magnetic_field.md
+++ b/docs/core/magnetic_field.md
@@ -1,3 +1,4 @@
+(magnetic-field-core)=
 # Magnetic field
 
 The magnetic field component of ACTS provides functionality to describe
@@ -104,7 +105,7 @@ cell*. The field cell can be retrieved for any given position. Since during
 typical access patterns, e.g. the propagation, subsequent steps are relatively
 likely to not cross the field cell boundary, the field cell can be cached.
 
-:::{figure} ../figures/bfield/field_cell.svg
+:::{figure} figures/bfield/field_cell.svg
 :width: 300
 :align: center
 Illustration of the field cell concept. Subsequent steps are clustered in the
@@ -121,7 +122,7 @@ methods:
 
 This intermediate interface is again implemented by
 {class}`Acts::InterpolatedBFieldMap`, which is a template class that depends on
-an instance of {class}`Acts::detail::Grid`. Varying configurations are possible,
+an instance of {class}`Acts::Grid`. Varying configurations are possible,
 like a 2D field map that exploits $rz$ symmetry, or a plain 3D grid.
 
 :::{doxygenclass} Acts::InterpolatedBFieldMap
@@ -163,7 +164,7 @@ to speed it up.
 ACTS also provides a field provider that calculates the field vectors
 analytically for a [solenoid](https://en.wikipedia.org/wiki/Solenoid) field. 
 
-:::{figure} ../figures/bfield/quiver.png
+:::{figure} figures/bfield/quiver.png
 :width: 600
 :align: center
 Picture of a solenoid field in rz, with arrows indicating the direction of the
@@ -224,7 +225,7 @@ $$
 
 In the implementation the factor of $(\mu_0\cdot I)$ is defined to be a scaling
 factor. It is evaluated and defined as the magnetic field in the center of the
-coil, i.e. the scale set in {any}`Acts::SolenoidBField::Config::bMagCenter`.
+coil, i.e. the scale set in {member}`Acts::SolenoidBField::Config::bMagCenter`.
 
 As the evaluation of $E_1(k^2)$ and $E_2(k^2)$ is **slow**. The
 {class}`Acts::InterpolatedBFieldMap` easily outperforms
diff --git a/docs/core/material.md b/docs/core/material.md
new file mode 100644
index 00000000000..cc6f76b6441
--- /dev/null
+++ b/docs/core/material.md
@@ -0,0 +1,20 @@
+(material-core)=
+
+# Material
+
+## Concept of passive material in tracking
+
+### Projective approximation of passive material
+
+:::{todo}
+Link to instructions how to run the material mapping in the examples
+:::
+
+### Volume based material description
+
+:::{todo}
+Improve material mapping technical description
+:::
+
+![](figures/material/MaterialAssignment.jpeg)
+![](figures/material/MaterialAveraging.jpeg)
diff --git a/docs/core/material.rst b/docs/core/material.rst
deleted file mode 100644
index bfcbf920cf6..00000000000
--- a/docs/core/material.rst
+++ /dev/null
@@ -1,79 +0,0 @@
-.. _material_core:
-
-Material
-========
-
-.. note::
-
-   This was originally written for the materials plugin that has been merged
-   into the material module
-
-The material module allow to map material from a detailed full detector geometry
-onto the simplified Acts geometry. The material is mapped onto layers of the
-tracking geometry which are marked to carry support material. The marking is
-done during the geometry building process. The material can be mapped onto
-either, the inner, the outer boundary surface or the central (representing)
-:class:`Acts::Surface` of the :class:`Acts::Layer`. The :class:`Acts::Material`
-is described on a two dimensional grid for each layer
-(:class:`Acts::BinnedSurfaceMaterial`). The user defines the granularity of the
-grid during the geometry building process.
-
-.. note::
-
-   The :doc:`/plugins/dd4hep` offers the possibility to mark layers which should
-   carry material and to determine the grid granularity, using the class
-   :class:`Acts::ActsExtension`.
-
-Following the Acts philosophy the material mapping is agnostic to any file
-format and software used to create or store the material maps. The material
-should be stored in instances of the class :class:`Acts::MaterialTrack`. This
-material track record represents a track starting from a certain position, in a
-certain direction, containing all material along this track. The material along
-the material track record is stored as a container of
-:class:`Acts::MaterialStep` instances. Each material step contains the material
-and its thickness at a certain position.
-
-The material mapping process can be split into two subprocesses:
-
-- Material assignment
-- Material averaging
-
-Material assignment
--------------------
-
-During the material assignment process the decision onto which layer each
-material step will be assigned is done. To assign a :class:`Acts::MaterialTrack`
-the function :func:`Acts::MaterialMapping::mapMaterial()` should be used. This
-function extrapolates through the tracking detector, with the start position and
-direction given by the material track record and collects all layers marked to
-carry material. Then it loops through all material steps of the material track
-record and assigns the material of each step to the closest layer:
-
-.. figure:: /figures/MaterialAssignment.jpeg
-
-   Example of material assignment onto the inner boundary surface of the
-   layers. The green points are assigned to the current inner layer, the red to
-   the next inner layer."
-
-Material averaging
-------------------
-
-During the material mapping the user can decide to average the material whenever
-they prefer by using the function
-:func:`Acts::MaterialMapping::averageLayerMaterial()`. In the end when all
-material track records have been mapped one should use the function
-:func:`Acts::MaterialMapping::finalizeLayerMaterial()` in order to finalize the
-process.
-
-The full material mapping process should be done in the framework of the user.
-
-Possible workflow:
-
-- Create material map(s) of full detector geometry using :class:`Acts::MaterialTrack`.
-- Read in material map(s) and go through all collected material track records.
-  Use :func:`Acts::MaterialMapping::mapMaterial()` for each material track
-  record.
-- Use :func:`Acts::MaterialMapping::averageLayerMaterial()` once per run.
-- In the end of the process use
-  :func:`Acts::MaterialMapping::finalizeLayerMaterial()` which assigns the
-  final material to the layers.
diff --git a/docs/figures/AxisBoundaryTypes.svg b/docs/core/misc/figures/AxisBoundaryTypes.svg
similarity index 100%
rename from docs/figures/AxisBoundaryTypes.svg
rename to docs/core/misc/figures/AxisBoundaryTypes.svg
diff --git a/docs/core/utilities/grid_axis.md b/docs/core/misc/grid_axis.md
similarity index 98%
rename from docs/core/utilities/grid_axis.md
rename to docs/core/misc/grid_axis.md
index 01555ab36d3..035c20ee4a0 100644
--- a/docs/core/utilities/grid_axis.md
+++ b/docs/core/misc/grid_axis.md
@@ -34,7 +34,7 @@ where $b \in \{0, 1, \ldots N_\text{bins}\}$. If the type is `Variable`, a searc
 `AxisBoundaryType` steers how out-of-bounds lookups are handled.
 There are three options:
 
-![The three different axis boundary types](/figures/AxisBoundaryTypes.svg)
+![The three different axis boundary types](figures/AxisBoundaryTypes.svg)
 
 - **Bound**: out-of-bounds lookups resolve to the closest valid bin.
 - **Open**: out-of-bounds lookups resolve to dedicated underflow and overflow bins.
diff --git a/docs/core/misc/index.md b/docs/core/misc/index.md
new file mode 100644
index 00000000000..a349c59ff57
--- /dev/null
+++ b/docs/core/misc/index.md
@@ -0,0 +1,7 @@
+# Miscellaneous
+
+:::{toctree}
+:maxdepth: 1
+grid_axis
+logging
+:::
diff --git a/docs/core/logging.md b/docs/core/misc/logging.md
similarity index 83%
rename from docs/core/logging.md
rename to docs/core/misc/logging.md
index 03a2c3c9fe4..8aa6abbe3c0 100644
--- a/docs/core/logging.md
+++ b/docs/core/misc/logging.md
@@ -5,7 +5,7 @@ control the amount of information displayed at run-time. Logger objects can
 easily be created using the {func}`Acts::getDefaultLogger` function which
 should be sufficient to get you started. In case you need more customized debug
 output, you can make use of the output decorators defined in
-{any}`Acts::Logging` or even write your own implementation of
+`Acts::Logging` or even write your own implementation of
 {class}`Acts::Logging::OutputDecorator`. In order to add debug messages to your
 program, you should use the provided macros for the different severity levels:
 
@@ -25,17 +25,24 @@ These macros correspond to the available log levels:
 :::
 
 
-The macros require that a function `logger()` returning a
-{class}`Acts::Logger` object is available in the scope in which the macros are
-used. Inside classes containing an {class}`Acts::Logger` object as member
-variable, this could be achieved by providing a private class method called
-`logger()` (for an example see e.g.
-{func}`Acts::CylinderVolumeBuilder::logger`). Inside free functions or member
-methods with local logger objects, the same effect can be achieved by using the
-macro `ACTS_LOCAL_LOGGER(...)` which is provided for your convenience.
+The macros require that a function `logger` returning a {class}`Acts::Logger`
+object is available in the scope in which the macros are used:
+
+```cpp
+const Logger& logger() const;
+```
+
+Inside classes
+containing an {class}`Acts::Logger` object as member variable, this could be
+achieved by providing a private class method called `logger()` (for an example
+see e.g.  {func}`Acts::CylinderVolumeBuilder::logger`). Inside free functions
+or member methods with local logger objects, the macros are also usable, since
+{class}`Acts::Logger` is callable and returns a reference to itself.
 
 Code example illustrating the usage:
 
+:::{doxygenfunction} Acts::getDefaultLogger
+:::
 
 ```cpp
 #include <fstream>
@@ -47,11 +54,9 @@ void myFunction() {
   // open the logfile
   std::ofstream logfile("log.txt");
   // setup a logger instance for >= INFO messages, streaming into the log file
-  // make sure you do NOT call the variable 'logger'
-  std::unique_ptr<const Acts::Logger> myLogger
+  std::unique_ptr<const Acts::Logger> logger
       = Acts::getDefaultLogger("MyLogger", Acts::Logging::INFO, &logfile);
   // make sure the Acts debug macros can work with your logger
-  ACTS_LOCAL_LOGGER(myLogger);
   ACTS_VERBOSE("This message will not appear in the logfile.");
   ACTS_INFO("But this one will: Hello World!");
   // do not forget to close the logfile
@@ -81,7 +86,7 @@ There are two approaches to logger integration:
 
     :::{note}
     ACTS code has iteratively moved to not construct loggers via
-    {func}`Acts::getDefaultLogger()` as much as possible, in favor of using a
+    {func}`Acts::getDefaultLogger` as much as possible, in favor of using a
     const-reference to {class}`Acts::Logger`. The latter can be defaulted to a
     dummy logger using {func}`Acts::getDummyLogger`. It is more suitable to
     pass into functions that might be called from other ACTS functions (rather
@@ -94,14 +99,14 @@ There are two approaches to logger integration:
 
 
 (override_deflog)=
-### Overriding `Acts::getDefaultLogger()`
+### Overriding `Acts::getDefaultLogger`
 
 :::{attention}
 Using this mechanism is now **discouraged** for integration with an experiment
 framework.
 :::
 
-Since Acts makes extensive use of {func}`Acts::getDefaultLogger()` to provide
+Since Acts makes extensive use of {func}`Acts::getDefaultLogger` to provide
 sufficient information for debugging, you might want to provide a modified
 implementation of this function (using your output filter and printing
 policies) to also pipe this output to your framework. You can use the following
@@ -129,7 +134,7 @@ $ LD_PRELOAD=<YOUR_SHARED_LIBRARY> path/to/your/executable
 ## Logging thresholds
 
 Generally, log levels in ACTS are only of informative value: even
-{any}`Acts::Logging::ERROR` and {any}`Acts::Logging::FATAL` will only print a
+{enumerator}`Acts::Logging::Level::ERROR` and {enumerator}`Acts::Logging::Level::FATAL` will only print a
 messages, **and not terminate execution**. 
 
 This is desirable in an experiment context, where jobs should not immediately
@@ -148,7 +153,7 @@ on their configuration, the logging can operate in three modes:
    `ACTS_ENABLE_LOG_FAILURE_THRESHOLD=ON` and
    `ACTS_LOG_FAILURE_THRESHOLD=<LEVEL>` are set, the logger code will compile
    in a fixed check if the log level of a particular message exceeds `<LEVEL>`.
-   If that is the case, an exception of type {class}`Acts::ThresholdFailure` is
+   If that is the case, an exception of type {class}`Acts::Logging::ThresholdFailure` is
    thrown.
 3. A **runtime log failure threshold** is set. If only
    `ACTS_ENABLE_LOG_FAILURE_THRESHOLD=ON` and no fixed threshold level is set,
diff --git a/docs/core/propagation.md b/docs/core/propagation.md
index df3bb8f9ef4..63213ca2f6d 100644
--- a/docs/core/propagation.md
+++ b/docs/core/propagation.md
@@ -18,12 +18,11 @@ The interaction of these two components is handled by the {class}`Acts::Propagat
 Propagator<Navigator, Stepper>
 ```
 
-Additional to these mandatory components, the propagator can be equipped with **Actors** and **Aborters** to allow for custom behaviour. These are function objects that are hooked in the propagation loop. Actors just perform some action on the propagator state (e.g. the {class}`Acts::KalmanFitter` is an actor), aborts can abort propagation (e.g., the {class}`Acts::PathLimitReached`).
+Additional to these mandatory components, the propagator can be equipped with **Actors** and **Aborters** to allow for custom behaviour. These are function objects that are hooked in the propagation loop. Actors just perform some action on the propagator state (e.g. the {class}`Acts::KalmanFitter` is an actor), aborts can abort propagation (e.g., the {struct}`Acts::PathLimitReached`).
 
 The propagator exposes its state to the actors and aborters as arguments to `operator()`. Actors must define a default-constructable `result_type`, which can be modified in each call:
 
 ```c++
-
 template<typename propagator_state_t, typename stepper_t>
 auto operator(propagator_state_t &state, const stepper_t &stepper, result_type &result) const {
   const auto &navigatorState = state.navigation;
@@ -36,7 +35,11 @@ The result of a propagation consists of the track parameters at the endpoint of
 
 ## Initialization and running
 
-The {class}`Acts::Propagator` is initialized with the helper class {class}`Acts::PropagatorOptions`, which is templated on the list of actors and aborters. This is done with the classes {class}`Acts::ActionList` and {class}`Acts::AbortList` (which are in fact small wrappers around `std::tuple`):
+The {class}`Acts::Propagator` is initialized with the helper class
+{struct}`Acts::PropagatorOptions`, which is templated on the list of actors and
+aborters. This is done with the classes {struct}`Acts::ActionList` and
+{struct}`Acts::AbortList` (which are in fact small wrappers around
+`std::tuple`):
 
 ```c++
 using MyOptions = Acts::PropagatorOptions<
@@ -45,7 +48,7 @@ using MyOptions = Acts::PropagatorOptions<
                   >;
 ```
 
-The actors and aborters are instantiated with the options and can be accessed with the `get`-method that expects the corresponding actor type as template parameter. Besides this, the {class}`Acts::PropagatorOptions` also contains a lot of general options like the `maxStepSize`:
+The actors and aborters are instantiated with the options and can be accessed with the `get`-method that expects the corresponding actor type as template parameter. Besides this, the {struct}`Acts::PropagatorOptions` also contains a lot of general options like the `maxStepSize`:
 
 ```c++
 auto options = MyOptions();
@@ -53,10 +56,10 @@ options.actionList.get<MyActor1>().foo = bar;
 options.maxStepSize = 100;
 ```
 
-All available options can be found in the {struct}`Acts::PropagatorPlainOptions`, from which {class}`Acts::PropagatorOptions` inherits.
+All available options can be found in the {struct}`Acts::PropagatorPlainOptions`, from which {struct}`Acts::PropagatorOptions` inherits.
 
 :::{tip}
-The propagator also contains a loop-protection mechanism. It estimates a circle perimeter from the momentum and the magnetic field, and aborts the propagation when a certain fraction (default: 0.5) of the circle has been propagated. This behaviour can be changed in the {class}`Acts::PropagatorOptions` via the boolean `loopProtection` and the float `loopFraction`.
+The propagator also contains a loop-protection mechanism. It estimates a circle perimeter from the momentum and the magnetic field, and aborts the propagation when a certain fraction (default: 0.5) of the circle has been propagated. This behaviour can be changed in the {struct}`Acts::PropagatorOptions` via the boolean `loopProtection` and the float `loopFraction`.
 :::
 
 To run the propagation, we must call the member function `propagate(...)` with the initial track parameters and the propagator options. There are several overloads to the `propagate(...)` function, which allow further customization:
@@ -75,7 +78,7 @@ if( res.ok() ) {
 
 ## Navigators
 
-Acts comes with two navigators: The standard navigator {class}`Acts::Navigator` that performs the full navigation in the volume/layer/surface hierarchy, and the {class}`Acts::DirectNavigator` that takes a sequence of surfaces and just navigates to one after the other. This sequence must be initialized with a special actor, the {class}`Acts::DirectNavigator::Initializer`.
+Acts comes with two navigators: The standard navigator {class}`Acts::Navigator` that performs the full navigation in the volume/layer/surface hierarchy, and the {class}`Acts::DirectNavigator` that takes a sequence of surfaces and just navigates to one after the other. This sequence must be initialized with a special actor, the {struct}`Acts::DirectNavigator::Initializer`.
 
 The navigators provide information about the current position inside the geometry in their state variable ({struct}`Acts::Navigator::State` and {struct}`Acts::DirectNavigator::State`), e.g. pointers to the `currentSurface` and the `currentVolume`.
 
@@ -108,7 +111,7 @@ The {class}`Acts::EigenStepper` implements the same functionality as the ATLAS s
 
 The extensions encapsulate the relevant equations for different environments. There exists a {type}`Acts::DefaultExtension` that is suited for propagation in a vacuum, and the {type}`Acts::DenseEnvironmentExtension`, that contains additional code to handle the propagation inside materials. Which extension is used is selected by a bidding-system.
 
-The extension can be configured via the {class}`Acts::StepperExtensionList`:
+The extension can be configured via the {struct}`Acts::StepperExtensionList`:
 
 ```c++
 using Stepper = Acts::EigenStepper<
@@ -123,4 +126,4 @@ By default, the {class}`Acts::EigenStepper` only uses the {type}`Acts::DefaultEx
 
 ### MultiEigenStepperLoop
 
-The {class}`Acts::MultiEigenStepper` is an extension of the {class}`Acts::EigenStepper` and is designed to internally handle a multi-component state, while interfacing as a single component to the navigator. It is mainly used for the {class}`Acts::GaussianSumFitter`.
+The {class}`Acts::MultiEigenStepperLoop` is an extension of the {class}`Acts::EigenStepper` and is designed to internally handle a multi-component state, while interfacing as a single component to the navigator. It is mainly used for the {struct}`Acts::GaussianSumFitter`.
diff --git a/docs/figures/gsf_bethe_heitler_approx.svg b/docs/core/reconstruction/figures/gsf_bethe_heitler_approx.svg
similarity index 100%
rename from docs/figures/gsf_bethe_heitler_approx.svg
rename to docs/core/reconstruction/figures/gsf_bethe_heitler_approx.svg
diff --git a/docs/figures/gsf_overview.svg b/docs/core/reconstruction/figures/gsf_overview.svg
similarity index 100%
rename from docs/figures/gsf_overview.svg
rename to docs/core/reconstruction/figures/gsf_overview.svg
diff --git a/docs/core/reconstruction/index.md b/docs/core/reconstruction/index.md
new file mode 100644
index 00000000000..bb29409dab1
--- /dev/null
+++ b/docs/core/reconstruction/index.md
@@ -0,0 +1,9 @@
+# Track reconstruction
+
+:::{toctree}
+:maxdepth: 1
+track_fitting
+preprocessing/preprocessing
+pattern_recognition/pattern_recognition
+vertexing
+:::
diff --git a/docs/figures/seeding/3Dcoordinates.svg b/docs/core/reconstruction/pattern_recognition/figures/seeding/3Dcoordinates.svg
similarity index 100%
rename from docs/figures/seeding/3Dcoordinates.svg
rename to docs/core/reconstruction/pattern_recognition/figures/seeding/3Dcoordinates.svg
diff --git a/docs/figures/seeding/impactParameter.svg b/docs/core/reconstruction/pattern_recognition/figures/seeding/impactParameter.svg
similarity index 100%
rename from docs/figures/seeding/impactParameter.svg
rename to docs/core/reconstruction/pattern_recognition/figures/seeding/impactParameter.svg
diff --git a/docs/figures/seeding/r-zCoordinates.svg b/docs/core/reconstruction/pattern_recognition/figures/seeding/r-zCoordinates.svg
similarity index 100%
rename from docs/figures/seeding/r-zCoordinates.svg
rename to docs/core/reconstruction/pattern_recognition/figures/seeding/r-zCoordinates.svg
diff --git a/docs/figures/seeding/tripletsFormation.svg b/docs/core/reconstruction/pattern_recognition/figures/seeding/tripletsFormation.svg
similarity index 100%
rename from docs/figures/seeding/tripletsFormation.svg
rename to docs/core/reconstruction/pattern_recognition/figures/seeding/tripletsFormation.svg
diff --git a/docs/figures/seeding/x-yCoordinates.svg b/docs/core/reconstruction/pattern_recognition/figures/seeding/x-yCoordinates.svg
similarity index 100%
rename from docs/figures/seeding/x-yCoordinates.svg
rename to docs/core/reconstruction/pattern_recognition/figures/seeding/x-yCoordinates.svg
diff --git a/docs/core/reconstruction/pattern_recognition/pattern_recognition.md b/docs/core/reconstruction/pattern_recognition/pattern_recognition.md
new file mode 100644
index 00000000000..8bb9e90fc81
--- /dev/null
+++ b/docs/core/reconstruction/pattern_recognition/pattern_recognition.md
@@ -0,0 +1,7 @@
+# Pattern recognition
+
+:::{toctree}
+:maxdepth: 1
+seeding
+track_finding
+:::
diff --git a/docs/core/seeding.md b/docs/core/reconstruction/pattern_recognition/seeding.md
similarity index 87%
rename from docs/core/seeding.md
rename to docs/core/reconstruction/pattern_recognition/seeding.md
index 5efe38a8d4a..4eab14b03cc 100644
--- a/docs/core/seeding.md
+++ b/docs/core/reconstruction/pattern_recognition/seeding.md
@@ -1,6 +1,6 @@
 (seeding_core)=
 
-# Track Seeding
+# Seeding
 
 To reduce the time needed to reconstruct particle tracks, a track seed
 (henceforth: seed) is created which serves as the initial direction for the track
@@ -24,7 +24,7 @@ The most typical way to create seeds is to combine measurements. In a homogeneou
 
 The seeding implementation in `Core/include/Acts/Seeding/` was written with a focus on parallelism and maintainability and as detector agnostic as possible, only assuming a (near) homogeneous magnetic field with particles originating from the central detector region. Cuts are configurable and can be plugged in as an algorithm which is called by the seeding. The seeding works on measurements or “SpacePoints” (SP), which need to provide $(x,y,z)$ coordinates with the $z$ axis being along the magnetic field, and $x$ and $y$. For the seeding algorithm to function the particle point of origin has to have a radius smaller than the radius of the detector layer closest to the interaction region. In other words, this seeding algorithm is not suitable for secondary particles originating far from the interaction region.
 
-:::{figure} ../figures/seeding/3Dcoordinates.svg
+:::{figure} figures/seeding/3Dcoordinates.svg
 :width: 550px
 :align: center
 Sketch of the detector with 3 layers. The interaction region is supposed to be located along the $z$-axis and has a size significantly smaller than the radius of the innermost detector layer.
@@ -40,16 +40,17 @@ lower energy particles.
 
 ### SP Grid and Groups Formation
 
-The SPs in each detector layer are projected on a rectangular grid of configurable
-granularity. The search for seed starts by selecting SP in the middle detector 
-layer. Then matching SPs are searched in the inner and outer layers. Grouping of 
-the SPs in the aforementioned grid allows to limit the search to neighbouring grid
-cells thus improving significantly algorithm performance (see {numref}`tripletsFormation`). The number of neighboring 
-bins used in the SP search can be defined separately for the bottom and top layer SPs
-in the $z$ and $\phi$ directions.
+The SPs in each detector layer are projected on a rectangular grid of
+configurable granularity. The search for seed starts by selecting SP in the
+middle detector layer. Then matching SPs are searched in the inner and outer
+layers. Grouping of the SPs in the aforementioned grid allows to limit the
+search to neighbouring grid cells thus improving significantly algorithm
+performance (see {numref}`tripletsFormation`). The number of neighboring bins
+used in the SP search can be defined separately for the bottom and top layer
+SPs in the $z$ and $\phi$ directions.
 
 (tripletsFormation)=
-:::{figure} ../figures/seeding/tripletsFormation.svg
+:::{figure} figures/seeding/tripletsFormation.svg
 :width: 450px
 :align: center
 Representation of the search for triplet combinations in the $(r, z)$ plane. The bins used in the search are represented in different colours.
@@ -57,7 +58,7 @@ Representation of the search for triplet combinations in the $(r, z)$ plane. The
 
 ### The Seed Finder
 
-The {func}`SeedFilter::createSeedsForGroup` function receives three iterators 
+The {func}`Acts::SeedFinder::createSeedsForGroup` function receives three iterators 
 over SPs constructed from detector layers of increasing radii. The seedfinder will 
 then attempt to create seeds, with each seed containing exactly one SP returned by 
 each of the three iterators. It starts by iterating over SPs in the middle layer
@@ -67,12 +68,20 @@ compatibility by applying a set of configurable cuts that can be tested with
 two SP only (pseudorapidity, origin along $z$-axis, distance in $r$ between SP,
 compatibility with interaction point).
 
+:::{doxygenfunction} Acts::SeedFinder::createSeedsForGroup(const Acts::SeedFinderOptions &options, SeedingState &state, const Acts::SpacePointGrid<external_spacepoint_t> &grid, std::back_insert_iterator<container_t<Seed<external_spacepoint_t>>> outIt, const sp_range_t &bottomSPs, const std::size_t middleSPs, const sp_range_t &topSPs, const Acts::Range1D<float> &rMiddleSPRange) const
+:::
+
+
+:::{doxygenfunction} Acts::SeedFinder::createSeedsForGroup(const Acts::SeedFinderOptions &options, const Acts::SpacePointGrid<external_spacepoint_t> &grid, const sp_range_t &bottomSPs, const std::size_t middleSPs, const sp_range_t &topSPs) const
+:::
+
+
 For all pairs passing the selection the triplets of bottom-middle-top SPs are formed.
 Each triplet is then confronted with the helix hypothesis. In order to perform calculations
 only once, the circle calculation is spread out over the three loops.
 
 (x-yCoordinates)=
-:::{figure} ../figures/seeding/x-yCoordinates.svg
+:::{figure} figures/seeding/x-yCoordinates.svg
 :width: 400px
 :align: center
 The x-y projection of the detector with the charged particle helical track originating from the centre of the detector. Signals left by the passage of the track through the detector layers are marked with green crosses.
@@ -114,7 +123,7 @@ Now we can apply a cut on the estimate of the minimum helix diameter `minHelixDi
 where $B_z$ is the magnetic field.
 
 (r-zCoordinates)=
-:::{figure} ../figures/seeding/r-zCoordinates.svg
+:::{figure} figures/seeding/r-zCoordinates.svg
 :width: 500px
 :align: center
 The r-z projection of the detector with the same charged particle track. The track is depicted with the same colours as in the previous figure.
@@ -157,7 +166,7 @@ before storing all top SP compatible with both the current middle SP and current
 bottom SP. 
 
 (impactParameter)=
-:::{figure} ../figures/seeding/impactParameter.svg
+:::{figure} figures/seeding/impactParameter.svg
 :width: 400px
 :align: center
 Helix representation in $x/y$ reference frame with central space-point (SP$_m$) in the origin.
@@ -180,7 +189,7 @@ d_0 \leq \left| \left( A - B \cdot r_M \right) \cdot r_M \right|
 
 After creating the potential seeds we apply a seed filter procedure that compares the seeds with other SPs compatible with the seed curvature.
 This process ranks the potential seeds based on certain quality criteria and selects the ones that are more likely to produce high-quality tracks 
-The filter is divided into two functions {func}`SeedFilter::filterSeeds_2SpFixed` and {func}`SeedFilter::filterSeeds_1SpFixed`.
+The filter is divided into two functions {func}`Acts::SeedFilter::filterSeeds_2SpFixed` and {func}`Acts::SeedFilter::filterSeeds_1SpFixed`.
 
 The first function compares the middle and bottom layer SPs of the seeds to other top layer SPs; seeds only differing in top SP are 
 compatible if they have similar helix radius with the same sign (i.e. the same charge). The SPs must have a minimum distance in 
@@ -209,7 +218,7 @@ likely to stem from a particle than another seed using the same middle SP with
 smaller impact parameters. The number of compatible seeds ($N_t$) is used to increase the weight, as a higher number of measurements 
 will lead to higher quality tracks.  Finally, the weight can also be affected by optional detector-specific cuts.
 
-The {func}`SeedFilter::filterSeeds_2SpFixed` function also includes a configurable {class}`Acts::SeedConfirmationRangeConfig` seed confirmation step that, when enabled,
+The {func}`Acts::SeedFilter::filterSeeds_2SpFixed` function also includes a configurable {struct}`Acts::SeedConfirmationRangeConfig` seed confirmation step that, when enabled,
 classifies higher quality seeds as "quality confined" seeds if they fall within a predefined range of parameters ($d_0$, $z_0$ and $N_t$) that also
 depends on the region of the detector (i.e., forward or central region). If the seed is not
 classified as "quality confined" seed, it will only be accepted if its weight is greater
diff --git a/docs/core/track_finding.md b/docs/core/reconstruction/pattern_recognition/track_finding.md
similarity index 67%
rename from docs/core/track_finding.md
rename to docs/core/reconstruction/pattern_recognition/track_finding.md
index b4b0f045f68..f03dab75389 100644
--- a/docs/core/track_finding.md
+++ b/docs/core/reconstruction/pattern_recognition/track_finding.md
@@ -1,12 +1,17 @@
 # Track Finding
 
-:::{note}
-This is a stub!
+:::{todo}
+Write CKF documentation
 :::
 
 (ckf_core)=
 ## Combinatorial Kalman Filter
 
+% Functional approach
+% Implementation as an actor
+% Limitations (no inward filtering)
+% Requirement to copy out after smoothing if smoothed track states are desired
+
 ## Machine-Learning based Track Finding
 
 There is a lot of research ongoing about machine-learning based approaches to Track Finding. Because these are not yet stable and bullet-prove, there are no such algorithms distributed with the core library. However, there exists a [plugin](exatrkxplugin), that implements the *Exa.TrkX* algorithm in ACTS.
diff --git a/docs/core/reconstruction/preprocessing/clustering.md b/docs/core/reconstruction/preprocessing/clustering.md
new file mode 100644
index 00000000000..aac786eddd5
--- /dev/null
+++ b/docs/core/reconstruction/preprocessing/clustering.md
@@ -0,0 +1,6 @@
+(clustering_core)=
+# Clustering
+
+:::{todo}
+Write clustering description
+:::
diff --git a/docs/core/reconstruction/preprocessing/preprocessing.md b/docs/core/reconstruction/preprocessing/preprocessing.md
new file mode 100644
index 00000000000..30f540f8e38
--- /dev/null
+++ b/docs/core/reconstruction/preprocessing/preprocessing.md
@@ -0,0 +1,6 @@
+# Preprocessing of event data
+
+:::{toctree}
+clustering
+spacepoint_formation
+:::
diff --git a/docs/core/spacepoint_formation.md b/docs/core/reconstruction/preprocessing/spacepoint_formation.md
similarity index 53%
rename from docs/core/spacepoint_formation.md
rename to docs/core/reconstruction/preprocessing/spacepoint_formation.md
index 36c54c0e96e..2e948456b4e 100644
--- a/docs/core/spacepoint_formation.md
+++ b/docs/core/reconstruction/preprocessing/spacepoint_formation.md
@@ -2,6 +2,6 @@
 
 # Spacepoint formation
 
-:::{note}
-This is a stub!
+:::{todo}
+Write spacepoint formation documentation
 :::
diff --git a/docs/core/track_fitting.md b/docs/core/reconstruction/track_fitting.md
similarity index 83%
rename from docs/core/track_fitting.md
rename to docs/core/reconstruction/track_fitting.md
index 279d946b523..4044f98762c 100644
--- a/docs/core/track_fitting.md
+++ b/docs/core/reconstruction/track_fitting.md
@@ -26,8 +26,8 @@ The KF can give us those three interpretations as sets of track parameters:
     * filtered: Uses the "current" data (i.e. the predicted data updated with the measurement on the current surface). It is some kind of weighted mean.
     * smoothed: Uses the "future" data to predict the current parameters. This can only be evaluated if the whole propagation is finished once. This can be done in to ways: one uses backwards-propagation and one does not.
 
-:::{note}
-This chapter will be extended in the future.
+:::{todo}
+Complete Kalman Filter description
 :::
 
 (gsf_core)=
@@ -46,7 +46,7 @@ f(z) = \frac{(- \ln z)^{c-1}}{\Gamma(c)}, \quad c = t/\ln 2
 $$
 
 (figBetheHeitler)=
-:::{figure} ../figures/gsf_bethe_heitler_approx.svg
+:::{figure} figures/gsf_bethe_heitler_approx.svg
 :width: 450px
 :align: center
 The true Bethe-Heitler distribution compared with a gaussian mixture approximation (in thin lines the individual components are drawn) at t = 0.1 (corresponds to ~ 10mm Silicon).
@@ -58,27 +58,27 @@ To be able to handle this with the Kalman filter mechanics, this distribution is
 * On a measurement surface, for each component a Kalman update is performed. Afterwards, the component weights are corrected according to each component's compatibility with the measurement.
 
 (figGsf)=
-:::{figure} ../figures/gsf_overview.svg
+:::{figure} figures/gsf_overview.svg
 :width: 450px
 :align: center
 Simplified overview of the GSF algorithm.
 :::
 
 ### The Multi-Stepper
-To implement the GSF, a special stepper is needed, that can handle a multi-component state internally: The {class}`Acts::MultiEigenStepperLoop`, which is based on the {class}`Acts::EigenStepper` and thus shares a lot of code with it. It interfaces to the navigation as one aggregate state to limit the navigation overhead, but internally processes a multi-component state. How this aggregation is performed can be configured via a template parameter, by default weighted average is used ({struct}`WeightedComponentReducerLoop`).
+To implement the GSF, a special stepper is needed, that can handle a multi-component state internally: The {class}`Acts::MultiEigenStepperLoop`, which is based on the {class}`Acts::EigenStepper` and thus shares a lot of code with it. It interfaces to the navigation as one aggregate state to limit the navigation overhead, but internally processes a multi-component state. How this aggregation is performed can be configured via a template parameter, by default weighted average is used ({struct}`Acts::WeightedComponentReducerLoop`).
 
-At the end of the fit the multi-component state must be reduced to a single set of parameters with a corresponding covariance matrix. This is supported by the {class}`Acts::MultiEigenStepperLoop` in two different ways currently: The *mean* method computes the mean and the covariance matrix of the multi-component state, whereas the *maximum weight* method just returns the component with the maximum weight. This can be configured in the constructor of the {class}`Acts::MultiEigenStepperLoop` with the {enum}`Acts::FinalReductionMethod`. In the future there is planned to add a *mode* finding method as well.
+At the end of the fit the multi-component state must be reduced to a single set of parameters with a corresponding covariance matrix. This is supported by the {class}`Acts::MultiEigenStepperLoop` in two different ways currently: The *mean* method computes the mean and the covariance matrix of the multi-component state, whereas the *maximum weight* method just returns the component with the maximum weight. This can be configured in the constructor of the {class}`Acts::MultiEigenStepperLoop` with the {enum}`Acts::MixtureReductionMethod`. In the future there is planned to add a *mode* finding method as well.
 
 :::{note}
 In practice it turned out that the *maximum weight* method leads to better results so far.
 :::
 
-Even though the multi-stepper interface exposes only one aggregate state and thus is compatible with most standard tools, there is a special aborter is required to stop the navigation when the surface is reached, the {class}`Acts::MultiStepperSurfaceReached`. It checks if all components have reached the target surface already and updates their state accordingly. Optionally, it also can stop the propagation when the aggregate state reaches the surface.
+Even though the multi-stepper interface exposes only one aggregate state and thus is compatible with most standard tools, there is a special aborter is required to stop the navigation when the surface is reached, the {struct}`Acts::MultiStepperSurfaceReached`. It checks if all components have reached the target surface already and updates their state accordingly. Optionally, it also can stop the propagation when the aggregate state reaches the surface.
 
 
 ### Using the GSF
 
-The GSF is implemented in the class {class}`Acts::GaussianSumFitter`. The interface of its `fit(...)`-functions is very similar to the one of the {class}`Acts::KalmanFitter` (one for the standard {class}`Acts::Navigator` and one for the {class}`Acts::DirectNavigator` that takes an additional `std::vector<const Acts::Surface *>` as an argument):
+The GSF is implemented in the class {struct}`Acts::GaussianSumFitter`. The interface of its `fit(...)`-functions is very similar to the one of the {class}`Acts::KalmanFitter` (one for the standard {class}`Acts::Navigator` and one for the {class}`Acts::DirectNavigator` that takes an additional `std::vector<const Acts::Surface *>` as an argument):
 
 ```{doxygenstruct} Acts::GaussianSumFitter
 ---
@@ -89,7 +89,7 @@ outline:
 
 The fit can be customized with several options, e.g., the maximum number of components. All options can be found in the {struct}`Acts::GsfOptions`.
 
-To simplify integration, the GSF returns an {class}`Acts::KalmanFitterResult` object, the same as the {class}`Acts::KalmanFitter`. This allows to use the same analysis tools for both fitters.
+To simplify integration, the GSF returns an {struct}`Acts::KalmanFitterResult` object, the same as the {class}`Acts::KalmanFitter`. This allows to use the same analysis tools for both fitters.
 
 If the GSF finds the column with the string identifier *"gsf-final-multi-component-state"* (defined in `Acts::GsfConstants::kFinalMultiComponentStateColumn`) in the track container, it adds the final multi-component state to the track as a `std::optional<Acts::MultiComponentBoundTrackParameters<SinglyCharged>>` object.
 
@@ -97,9 +97,9 @@ A GSF example can be found in the Acts Examples Framework [here](https://github.
 
 ### Customising the Bethe-Heitler approximation
 
-The GSF needs an approximation of the Bethe-Heitler distribution as a Gaussian mixture on each material interaction (see above). This task is delegated to a separate class, that can be provided by a template parameter to {class}`Acts::GaussianSumFitter`, so in principle it can be implemented in different ways.
+The GSF needs an approximation of the Bethe-Heitler distribution as a Gaussian mixture on each material interaction (see above). This task is delegated to a separate class, that can be provided by a template parameter to {struct}`Acts::GaussianSumFitter`, so in principle it can be implemented in different ways.
 
-However, ACTS ships with the class {class}`Acts::AtlasBetheHeitlerApprox` that implements the ATLAS strategy for this task: To be able to evaluate the approximation of the Bethe-Heitler distribution for different materials and thicknesses, the individual Gaussian components (weight, mean, variance of the ratio $E_f/E_i$) are parametrised as polynomials in $x/x_0$. This class can load files in the ATLAS format that can be found [here](https://gitlab.cern.ch/atlas/athena/-/tree/master/Tracking/TrkFitter/TrkGaussianSumFilter/Data). A default parameterization can be created with {func}`Acts::makeDefaultBetheHeitlerApprox`.
+However, ACTS ships with the class {class}`Acts::AtlasBetheHeitlerApprox` that implements the ATLAS strategy for this task: To be able to evaluate the approximation of the Bethe-Heitler distribution for different materials and thicknesses, the individual Gaussian components (weight, mean, variance of the ratio $E_f/E_i$) are parametrised as polynomials in $x/x_0$. This class can load files in the ATLAS format that can be found [here](https://gitlab.cern.ch/atlas/athena/-/tree/main/Tracking/TrkFitter/TrkGaussianSumFilter/Data). A default parameterization can be created with {func}`Acts::makeDefaultBetheHeitlerApprox`.
 
 The {class}`Acts::AtlasBetheHeitlerApprox` is constructed with two parameterizations, allowing to use different parameterizations for different $x/x_0$. In particular, it has this behaviour:
 * $x/x_0 < 0.0001$: Return no change
@@ -108,14 +108,16 @@ The {class}`Acts::AtlasBetheHeitlerApprox` is constructed with two parameterizat
 * $x/x_0 \geq 0.1$: Return the approximation for high $x/x_0$. The maximum possible value is $x/x_0 = 0.2$, for higher values it is clipped to 0.2 and the GSF emits a warning.
 
 ### Further reading
+
 * *Thomas Atkinson*, Electron reconstruction with the ATLAS inner detector, 2006, see [here](https://cds.cern.ch/record/1448253)
 * *R Frühwirth*, Track fitting with non-Gaussian noise, 1997, see [here](https://doi.org/10.1016/S0010-4655(96)00155-5)
 * *R Frühwirth*, A Gaussian-mixture approximation of the Bethe–Heitler model of electron energy loss by bremsstrahlung, 2003, see [here](https://doi.org/10.1016/S0010-4655(03)00292-3)
 
 (gx2f_core)=
 ## Global Chi-Square Fitter (GX2F) [wip]
-:::{note}
-This chapter will be added soon.
+
+:::{todo}
+Write GX2F documeneation
 :::
 
 [^billoir]: https://twiki.cern.ch/twiki/pub/LHCb/ParametrizedKalman/paramKalmanV01.pdf
diff --git a/docs/core/reconstruction/vertexing.md b/docs/core/reconstruction/vertexing.md
new file mode 100644
index 00000000000..96d607b194a
--- /dev/null
+++ b/docs/core/reconstruction/vertexing.md
@@ -0,0 +1,6 @@
+(vertexing_core)=
+# Vertexing
+
+:::{todo}
+Write vertexing documentation
+:::
diff --git a/docs/core/vertexing.md b/docs/core/vertexing.md
deleted file mode 100644
index 5c05f114d35..00000000000
--- a/docs/core/vertexing.md
+++ /dev/null
@@ -1,6 +0,0 @@
-(vertexing_core)=
-# Vertexing
-
-:::{note}
-This is a stub!
-:::
diff --git a/docs/core/visualization/visualization.rst b/docs/core/visualization/3d.md
similarity index 79%
rename from docs/core/visualization/visualization.rst
rename to docs/core/visualization/3d.md
index d533b7831f4..50b302c7f23 100644
--- a/docs/core/visualization/visualization.rst
+++ b/docs/core/visualization/3d.md
@@ -1,5 +1,4 @@
-Visualization
-=============
+# 3D Visualization
 
 A very lightweight layer for visualizing Acts geometry objects and event data model is provided within the Core component.
 Acts does not provide a viewer per se, but instead it was chosen to plug a visitor that can then be used for visualizing the given objects.
@@ -11,8 +10,7 @@ The two provided visualization visitors are:
  * `ObjVisualization3D` writing the `.obj` format, and an associated `.mtl` file for the color and material definitions
  * `PlyVisualization3D` writing the `.ply` format, which contains already the color/material information
 
-Behind the scene
-----------------
+## Behind the scenes
 
 All display actions rely on the `Polyhedron` representation of Surfaces, 
 i.e. each surface can be at least approximated by a list of vertices and a definition of faces connecting these vertices.
@@ -20,8 +18,7 @@ As a special feature, the `Polyhedron` can be displayed as a triangulated mesh o
 that build up the object to display.
 
 
-Convenience helper functions
-----------------------------
+## Convenience helper functions
 
 The visualization package also contains `static` helper functions for displaying complicated objects; these helper functions are provided by the `GeometryView3D` and `EventDataView3D` structs, that receive:
  * A visualization visitor
@@ -36,24 +33,28 @@ The visualization package also contains `static` helper functions for displaying
 
 Example of an angular error cone:
 
- .. image:: ../../figures/visualization/AngularError.png
-  :width: 800
-  :alt: Display of an angular error. 
+:::{image} figures/AngularError.png
+:width: 800
+:alt: Display of an angular error. 
+:::
 
 Example of a 2D cartesian error on a plane:
 
- .. image:: ../../figures/visualization/CartesianError.png
-  :width: 800
-  :alt: Display of a cartesian error.
+:::{image} figures/CartesianError.png
+:width: 800
+:alt: Display of a cartesian error.
+:::
 
 Example of track parameters on a plane:
 
- .. image:: ../../figures/visualization/Parameters.png
-  :width: 800
-  :alt: Display of a track parameter object.
+:::{image} figures/Parameters.png
+:width: 800
+:alt: Display of a track parameter object.
+:::
 
 Example of a cylindrical layer with sensitive volumes and a surface grid:
 
- .. image:: ../../figures/visualization/CylinderLayer.png
-  :width: 800
-  :alt: Display of a track parameter object.
+:::{image} figures/CylinderLayer.png
+:width: 800
+:alt: Display of a track parameter object.
+:::
diff --git a/docs/figures/visualization/AngularError.png b/docs/core/visualization/figures/AngularError.png
similarity index 100%
rename from docs/figures/visualization/AngularError.png
rename to docs/core/visualization/figures/AngularError.png
diff --git a/docs/figures/visualization/CartesianError.png b/docs/core/visualization/figures/CartesianError.png
similarity index 100%
rename from docs/figures/visualization/CartesianError.png
rename to docs/core/visualization/figures/CartesianError.png
diff --git a/docs/figures/visualization/CylinderLayer.png b/docs/core/visualization/figures/CylinderLayer.png
similarity index 100%
rename from docs/figures/visualization/CylinderLayer.png
rename to docs/core/visualization/figures/CylinderLayer.png
diff --git a/docs/figures/visualization/Parameters.png b/docs/core/visualization/figures/Parameters.png
similarity index 100%
rename from docs/figures/visualization/Parameters.png
rename to docs/core/visualization/figures/Parameters.png
diff --git a/docs/core/visualization/index.md b/docs/core/visualization/index.md
new file mode 100644
index 00000000000..c0e2d365abc
--- /dev/null
+++ b/docs/core/visualization/index.md
@@ -0,0 +1,7 @@
+# Visualization
+
+:::{toctree}
+:maxdepth: 1
+3d
+svg
+:::
diff --git a/docs/core/visualization/svg.md b/docs/core/visualization/svg.md
new file mode 100644
index 00000000000..43ff3ed32e3
--- /dev/null
+++ b/docs/core/visualization/svg.md
@@ -0,0 +1,7 @@
+# SVG for 2D visualization
+
+:::{todo}
+Add documentation for SVG visualization
+- How do I run it with an existing geometry
+- What do I need to customize?
+:::
diff --git a/docs/examples/alignment.md b/docs/examples/alignment.md
index 01888f2ab76..559507c2956 100644
--- a/docs/examples/alignment.md
+++ b/docs/examples/alignment.md
@@ -1 +1,5 @@
 # Alignment prototype
+
+:::{todo}
+Write Alignment prototype documentation
+:::
diff --git a/docs/examples/digizier_config.md b/docs/examples/digizier_config.md
deleted file mode 100644
index d3668ee1866..00000000000
--- a/docs/examples/digizier_config.md
+++ /dev/null
@@ -1 +0,0 @@
-# Digitizer config
diff --git a/docs/examples/examples.rst b/docs/examples/examples.rst
index 309efbd4d69..3b9777d14e0 100644
--- a/docs/examples/examples.rst
+++ b/docs/examples/examples.rst
@@ -41,8 +41,6 @@ At the time of writing, there are two aspects to the ACTS examples:
    :maxdepth: 2
 
    Python bindings <python_bindings>
-   full_chain_odd
-   material_mapping
-   digizier_config
+   OpenDataDetector full chain <full_chain_odd>
    alignment
-   Analysis Apps <analysis_apps>
+   How-to guides <howto/howto>
diff --git a/docs/howto/add_new_algorithm.md b/docs/examples/howto/add_new_algorithm.md
similarity index 56%
rename from docs/howto/add_new_algorithm.md
rename to docs/examples/howto/add_new_algorithm.md
index 0f91171a06d..33d594ca03e 100644
--- a/docs/howto/add_new_algorithm.md
+++ b/docs/examples/howto/add_new_algorithm.md
@@ -27,13 +27,25 @@ The `CMakeLists.txt` file needs to be updated as well.
 
 ## Algorithm Class
 
-The algorithm class has to inherit from {class}`ActsExamples::IAlgorithm`
+The algorithm class has to inherit from `ActsExamples::IAlgorithm`
 and thus implement this single method:
 
 ```cpp
-    ProcessCode execute(const AlgorithmContext& ctx) const final;
+ProcessCode execute(const AlgorithmContext& ctx) const final;
 ```
 
+Optionally, they can also override the following lifecycle methods which are
+called at the beginning and end of the event loop:
+
+```cpp
+ProcessCode initialize() final;
+ProcessCode finalize() final;
+```
+
+Note that these methods are not `const`, meaning they can manipulate members of
+the algorithm object. This is safe because these methods are only called from a
+single thread.
+
 :::{hint}
 There are other types of algorithms for reading inputs from files
 or for saving data to files. All these interfaces can be found in
@@ -54,20 +66,18 @@ This way it becomes reentrant and in consequence thread safe.
 For instance if the event processing is best organized with such methods:
 
 ```cpp
-
-    void prepareBuffers();
-    void fillBuffers( const SpacePoint& );
-    void extractInfo();
+void prepareBuffers();
+void fillBuffers( const SpacePoint& );
+void extractInfo();
 ```
 
 that need to pass the data between each other these methods should rather look like this:
 
 ```cpp
-
-    struct SeedingBuffers{ ... some buffers ... };
-    void prepareBuffers(SeedingBuffers& buffers);
-    void fillBuffers(SeedingBuffers& buffers, const SpacePoint& );
-    void extractInfo(const SeedingBuffers& buffers);
+struct SeedingBuffers{ ... some buffers ... };
+void prepareBuffers(SeedingBuffers& buffers);
+void fillBuffers(SeedingBuffers& buffers, const SpacePoint& );
+void extractInfo(const SeedingBuffers& buffers);
 ```
 
 :::{tip}
@@ -76,32 +86,57 @@ It is common practice to put the algorithm code in the `ActsExamples` namespace.
 
 ## Input and Output
 
-The algorithm would be typically part of some processing sequence
-and thus consume and produce some event data.
-In the hypothetical example discussed here,
-space-points are the input and track seeds an output.
-The data can be retrieved in the algorithm using the `get` method of the "store" object of such signature:
+The algorithm would be typically part of some processing sequence and thus
+consume and produce some event data.  In the hypothetical example discussed
+here, space-points are the input and track seeds an output. 
+
+Data is passed between algorithms through a central *event store*, basically a
+dictionary type that can store arbitrary value types in memory.
+
+The data can be retrieved using special *handle* objects that encode a on
+object type and the name with which they are associated in the event store.
 
+To add an input and output to your algorithm, in the class declaration add handles like
 
 ```cpp
-    template<typename T>
-    const T& get(const std::string& name);
-    // example
-    ctx.eventStore.get<MyType>("A_name");
+ReadDataHandle<SimSpacePointContainer> m_inputSpacePoints{this, "InputSpacePoints"};
+WriteDataHandle<SimSeedContainer> m_outputSeeds{this, "OutputSeeds"};
 ```
-The data is fetched from the "store" that is populated by a preceding algorithm or by the reader.
 
-The data object (or objects) produced by an algorithm can be placed in the store using "store" `add` method:
+The first argument is needed to register the handles with the owning algorithm,
+while the second argument is the *handle name* that is used in debug printouts
+to identify the handle.
+
+In your algorithm constructor, you can then *initialize* the handles with a
+key, that is used to read and write the data objects to and from the event
+store. This key can be hard-coded, or you can make it configurable by making it
+a property of the algorithm `Config` nested struct.
+
+This initialization can look something like this:
 
 ```cpp
+m_inputSpacePoints.initialize(m_cfg.inputSpacePoints);
+m_outputSeeds.initialize(m_cfg.outputSeeds);
+```
+
+where both `m_cfg.inputSpacePoints` and `m_cfg.outputSeeds` are simple strings.
+
+To read data inside your `execute` function, you can use these
+handles with the event context given as an argument:
+
+```cpp
+const auto& inputSpacePoints = m_inputSpacePoints(ctx);
+```
+
+The data object (or objects) produced by an algorithm can be placed in the
+store by calling the output handle like this:
 
-    template<typename T>
-    void add(const std::string& name, T&& object);
-    // example
-    ctx.eventStore.add("A_name", std::move(mydata));
+```cpp
+auto mydata = makeData();
+m_outputSeeds(ctx, std::move(mydata));
 ```
-The ownership of the object is transferred to the store.
-That is, the destruction of this object at the end of event processing is taken care of.
+The ownership of the object is transferred to the store.  That is, the
+destruction of this object at the end of event processing is taken care of.
 
 ## Configurability
 
@@ -114,12 +149,12 @@ That is how the configuration object could look like for `MySeedingAlgorithm`:
 
 ```cpp
 class MySeedingAlgoritm : ...
-    public:
-    struct Config {
-        std::vector<int> layers; // layers to use by the seeder
-        float deltaZ;  // the maximum allowed deviation in r-z plane
-    };
-    ...
+public:
+struct Config {
+    std::vector<int> layers; // layers to use by the seeder
+    float deltaZ;  // the maximum allowed deviation in r-z plane
+};
+  ...
 ```
 :::{tip}
 It is customary to put the config structures in the ``Acts`` namespace.
@@ -129,10 +164,9 @@ The algorithm constructor would take a `MySeedingAlgorithm::Config` object durin
 the construction in addition to an argument controlling verbosity of diagnostic messages.
 
 ```cpp
-
-    MySeedingAlgorithm::MySeedingAlgorithm( Config cfg, Acts::Logging::Level lvl):
-      ActsExamples::BareAlgortihm("MySeedingAlgorithm", lvl),
-      m_cfg(std::move(cfg)){...}
+MySeedingAlgorithm::MySeedingAlgorithm( Config cfg, Acts::Logging::Level lvl):
+  ActsExamples::BareAlgortihm("MySeedingAlgorithm", lvl),
+  m_cfg(std::move(cfg)){...}
 ```
 ## Python bindings
 
@@ -146,19 +180,18 @@ in this particular case the file to edit would be `TrackFinding.cpp`.
 The algorithm class and associated config class can be made known to python via such binding definition:
 
 ```cpp
-    ACTS_PYTHON_DECLARE_ALGORITHM(
-      ActsExamples::MySeedingAlgorithm,
-      "MySeedingAlgorithm",
-      layers, deltaZ);
+ACTS_PYTHON_DECLARE_ALGORITHM(
+  ActsExamples::MySeedingAlgorithm,
+  "MySeedingAlgorithm",
+  layers, deltaZ);
 ```
 
 The bindings can be tested in a standalone python session:
 
 ```python
-
-    from acts .examples import *
-    help(MySeedingAlgorithm)
-    help(MySeedingConfig)
+from acts .examples import *
+help(MySeedingAlgorithm)
+help(MySeedingConfig)
 ```
 An info about the class and config structure should be printed.
 
diff --git a/docs/examples/analysis_apps.rst b/docs/examples/howto/analysis_apps.rst
similarity index 98%
rename from docs/examples/analysis_apps.rst
rename to docs/examples/howto/analysis_apps.rst
index de35b7dbd6b..888e9f873bb 100644
--- a/docs/examples/analysis_apps.rst
+++ b/docs/examples/howto/analysis_apps.rst
@@ -104,7 +104,7 @@ The resulting file contains the following histograms:
 Only histograms with non-zero contribution are written out per specified region,
 the following shows a resulting stacked histogram showing different components:
 
-.. figure:: ../figures/examples/aa_mc_stacked_x0.gif  
+.. figure:: figures/analysis_apps/aa_mc_stacked_x0.gif
    :width: 500
 
 The source code for this application can be found in ``Examples/Scripts/MaterialMapping``.
@@ -160,7 +160,7 @@ layers and volumes and create detailed and summary plots for all of them.
 As a example, the pull distributions for *predicted, filtered* and *smoothed* track states 
 is shown below.
 
-.. figure:: ../figures/examples/aa_rp_layers.png  
+.. figure:: figures/analysis_apps/aa_rp_layers.png  
    :width: 500
 
 
@@ -228,11 +228,11 @@ using the ``--peak-events`` option.
 Some example histograms (transverse impact parameter ``d0`` distribution or a summary plot showing
 the number of detector hits, are added below).
 
-.. figure:: ../figures/examples/aa_ts_d0.png  
+.. figure:: figures/analysis_apps/aa_ts_d0.png  
    :width: 500
 
 
-.. figure:: ../figures/examples/aa_ts_nhits.png  
+.. figure:: figures/analysis_apps/aa_ts_nhits.png  
    :width: 500
 
 
diff --git a/docs/examples/howto/smearing_digitization_config.md b/docs/examples/howto/digitization_config.md
similarity index 100%
rename from docs/examples/howto/smearing_digitization_config.md
rename to docs/examples/howto/digitization_config.md
diff --git a/docs/figures/examples/aa_mc_stacked_x0.gif b/docs/examples/howto/figures/analysis_apps/aa_mc_stacked_x0.gif
similarity index 100%
rename from docs/figures/examples/aa_mc_stacked_x0.gif
rename to docs/examples/howto/figures/analysis_apps/aa_mc_stacked_x0.gif
diff --git a/docs/figures/examples/aa_rp_layers.png b/docs/examples/howto/figures/analysis_apps/aa_rp_layers.png
similarity index 100%
rename from docs/figures/examples/aa_rp_layers.png
rename to docs/examples/howto/figures/analysis_apps/aa_rp_layers.png
diff --git a/docs/figures/examples/aa_ts_d0.png b/docs/examples/howto/figures/analysis_apps/aa_ts_d0.png
similarity index 100%
rename from docs/figures/examples/aa_ts_d0.png
rename to docs/examples/howto/figures/analysis_apps/aa_ts_d0.png
diff --git a/docs/figures/examples/aa_ts_nhits.png b/docs/examples/howto/figures/analysis_apps/aa_ts_nhits.png
similarity index 100%
rename from docs/figures/examples/aa_ts_nhits.png
rename to docs/examples/howto/figures/analysis_apps/aa_ts_nhits.png
diff --git a/docs/figures/materialMapping/ActsMaterialMappingAutoTuning.png b/docs/examples/howto/figures/materialMapping/ActsMaterialMappingAutoTuning.png
similarity index 100%
rename from docs/figures/materialMapping/ActsMaterialMappingAutoTuning.png
rename to docs/examples/howto/figures/materialMapping/ActsMaterialMappingAutoTuning.png
diff --git a/docs/figures/materialMapping/approach_layers.png b/docs/examples/howto/figures/materialMapping/approach_layers.png
similarity index 100%
rename from docs/figures/materialMapping/approach_layers.png
rename to docs/examples/howto/figures/materialMapping/approach_layers.png
diff --git a/docs/figures/materialMapping/boundaries.png b/docs/examples/howto/figures/materialMapping/boundaries.png
similarity index 100%
rename from docs/figures/materialMapping/boundaries.png
rename to docs/examples/howto/figures/materialMapping/boundaries.png
diff --git a/docs/figures/materialMapping/layers_for_volume_17.png b/docs/examples/howto/figures/materialMapping/layers_for_volume_17.png
similarity index 100%
rename from docs/figures/materialMapping/layers_for_volume_17.png
rename to docs/examples/howto/figures/materialMapping/layers_for_volume_17.png
diff --git a/docs/figures/materialMapping/volumes_and_layers.png b/docs/examples/howto/figures/materialMapping/volumes_and_layers.png
similarity index 100%
rename from docs/figures/materialMapping/volumes_and_layers.png
rename to docs/examples/howto/figures/materialMapping/volumes_and_layers.png
diff --git a/docs/examples/howto/howto.md b/docs/examples/howto/howto.md
index fa08e305b70..4da7277e3cd 100644
--- a/docs/examples/howto/howto.md
+++ b/docs/examples/howto/howto.md
@@ -1,24 +1,10 @@
----
-orphan: true
----
-
-(howto-examples)=
-# How-to guides
-
-:::{attention}
-This section presents various workflows using the example executables.
-These executables are **deprecated**, and the python bindings should be used
-to run example workflows (see [](python-bindings)).
-:::
+# How-to guides for the Examples
 
 :::{toctree}
 :maxdepth: 1
-run_fatras
-run_seeding
-run_sycl_seed_finding
-run_truth_tracking
-run_ckf_tracking
-setup_and_run_vertexing
-run_alignment
-smearing_digitization_config.md
+add_new_algorithm
+analysis_apps
+material_mapping
+run_ckf_auto_tuning
+digitization_config
 :::
diff --git a/docs/howto/run_material_mapping.rst b/docs/examples/howto/material_mapping.rst
similarity index 96%
rename from docs/howto/run_material_mapping.rst
rename to docs/examples/howto/material_mapping.rst
index c86130caa2e..790f078f644 100644
--- a/docs/howto/run_material_mapping.rst
+++ b/docs/examples/howto/material_mapping.rst
@@ -1,10 +1,11 @@
-(material_howto_core)=
-# Howto run the material mapping and validation
+.. _material_mapping_howto_examples:
 
-ACTS Material Mapping Tutorial
-==============================
+Howto run the material mapping and validation
+=============================================
 
-(This how to uses **deprecated** executables and will be updated soon)
+.. note::
+   This documentation is for running the material mapping in the Examples framework.
+   Documentation on how to use the Core library directly for material mapping is found :ref:`here<material_mapping_howto_core>`.
 
 When performing track reconstruction, the proper amount of material crossed by the particle needs to be accounted for. This material is originally available in the detector simulation with a lot of details, which would make it expensive to directly use. To circumvent this issue, the material is mapped onto different surfaces in the tracking geometry. This process will be performed in 3 steps: 
 
@@ -122,19 +123,19 @@ This command produces a series of plots in the output folder ``plot``, or set a
 
 The picture ``volumes_and_layers.png`` show you the volumes and all layers constructed in them:
 
-.. image:: /figures/materialMapping/volumes_and_layers.png
+.. image:: figures/materialMapping/volumes_and_layers.png
 
 For each volume containing layers, another picture is produced to show the representative layers (without ``approach`` index) and highlight the ones with ``approach`` index. The picture below show layers for one of the ODD volumes. Knowledge of the approach layers is needed to select the lyers you want the material to be mapped onto.
 
-.. image:: /figures/materialMapping/layers_for_volume_17.png
+.. image:: figures/materialMapping/layers_for_volume_17.png
 
 The totality of representative and approach layers is shown in a separate picture ``approach_layers.png``.
 
-.. image:: /figures/materialMapping/approach_layers.png
+.. image:: figures/materialMapping/approach_layers.png
 
 Additionally, another picture is produced to visualise boundaries of volumes containing layers.
 
-.. image:: /figures/materialMapping/boundaries.png
+.. image:: figures/materialMapping/boundaries.png
 
 The same script can be used to dump a steering file that can help you selecting boundaries and approach layers you want the material to be mapped onto, using ``--dump_steering``. At this point you have to edit the steering file which has to contain **ONLY** the structures on which you want to map the material. Once this is done, you can read the steering file with the same python module to produce the final material map file to run material mapping. This is done enabling ``--edit``. At the end of the process, another plot is produced to visualise and validate the structures that will be selected in the mapping procedure to carry material.
 
@@ -232,4 +233,4 @@ Can be use with X,Y,Z is a list of volumes, this will plot the material ratio be
 Using a different detector
 --------------------------
 
-If you want to use a different type of detector, you will first need to ensure that the relevant packages were added during the compilation. After this you can just replace the detector initialisation in the different main function. For reference you can have a look on the Odd for DD4Hep detector and on the ITk for TGeo detector. 
+If you want to use a different type of detector, you will first need to ensure that the relevant packages were added during the compilation. After this you can just replace the detector initialisation in the different main function. For reference you can have a look on the ODD for DD4Hep detector and on the ITk for TGeo detector. 
diff --git a/docs/examples/howto/run_alignment.rst b/docs/examples/howto/run_alignment.rst
deleted file mode 100644
index e02e991e10f..00000000000
--- a/docs/examples/howto/run_alignment.rst
+++ /dev/null
@@ -1,56 +0,0 @@
-Run the alignment examples
-===============================
-
-Prerequisites
--------------
-
-Acts must be build with activated examples, Pythia8 and alignment support
-(``ACTS_BUILD_EXAMPLES_PYTHIA8=on`` and ``ACTS_BUILD_ALIGNMENT=on``) to enable the fast simulation. ``<build>``
-is used to identify the path to the build directory.
-
-We assume that you have generated a simulation dataset based on the TrackML detector as described in :ref:`simulate-TrackML`. An example dataset for running the alignment would be e.g. a single muon sample in a 2T magnetic field. Suppose the generated single muon sample is available at ``data/sim_trackML/single_muon``. 
-
-Run track fitting with misaligned detector 
-------------------------------------------
-
-The effects of misalignment on the track parameters estimation can be mimicked by decorating some misalignment to the detector. The AlignedDetector and PayloaDetector are two 'misaligned' versions of the TrackML detector. The difference between them is that they have different handling of the alignment parameters for the detector modules. In addition to the options as used for truth fitting in :ref:`truth-fit-TrackML`, additional options for misalignment decoration must be specified to run the track fiting with the AlignedDetector: 
-
-.. code-block:: console
-
-   $ <build>/bin/ActsExampleDetectorAlignContextual \
-       --input-dir=data/sim_trackML/single_muon \
-       --digi-config-file <source>/Examples/Algorithms/Digitization/share/default-smearing-config-generic.json \
-       --bf-constant-tesla=0:0:2 \
-       --align-sigma-iplane 100 \ 
-       --align-sigma-oplane 0 \
-       --align-sigma-irot 10 \
-       --align-sigma-orot 0 \
-       --output-dir=data/reco_misalignedTrackML_nonaligned/single_muon
-
-
-The ``--digi-config-file`` specifies the path for the digitization configuration file. The magnetic field setup should be consistent between simulation and the track fitting. 
-The ``--align-sigma-iplane`` and ``--align-sigma-oplane`` specifies the standard deviation of the shifts of the detector element in um within the plane and out of plane, respectively. 
-The ``--align-sigma-oplane`` and ``--align-sigma-orot`` specifies the standard deviation of the rotation of the detector element in mrad around the direction normal and parallel to the plane, respectively.
-
-
-Run detector alignment and refit with misalignment corrected 
------------------------------------------------------------- 
-
-Alignment can be run to estimate the misalignment, which can then be further used to correct the alignment parameters of the detector elements. To run track fitting with some misalignment decorated as above and also corrected by running alignment prior to it:
-
-.. code-block:: console
-
-   $ <build>/bin/ActsExampleDetectorAlignContextual \
-       --input-dir=data/sim_trackML/single_muon \
-       --digi-config-file <source>/Examples/Algorithms/Digitization/share/default-smearing-config-generic.json \
-       --bf-constant-tesla=0:0:2 \
-       --align-sigma-iplane 100 \
-       --align-sigma-oplane 0 \
-       --align-sigma-irot 10 \
-       --align-sigma-orot 0 \
-       --reco-with-misalignment-correction true \
-       --alignment-geo-config-file <source>/Examples/Algorithms/Alignment/share/alignment-geo-contextualDetector.json \
-       --output-dir=data/reco_misalignedTrackML_aligned/single_muon
-
-
-The ``--reco-with-misalignment-correction`` must be true to turn on the alignment, and the ``--alignment-geo-config-file`` is a JSON file to specify which detector objects are to be aligned. Currently, only module level alignment is possible. 
diff --git a/docs/howto/run_ckf_auto_tuning.rst b/docs/examples/howto/run_ckf_auto_tuning.rst
similarity index 100%
rename from docs/howto/run_ckf_auto_tuning.rst
rename to docs/examples/howto/run_ckf_auto_tuning.rst
diff --git a/docs/examples/howto/run_ckf_tracking.rst b/docs/examples/howto/run_ckf_tracking.rst
deleted file mode 100644
index 9d7c67a6b72..00000000000
--- a/docs/examples/howto/run_ckf_tracking.rst
+++ /dev/null
@@ -1,60 +0,0 @@
-Run the CombinatorialKalmanFilter (CKF) tracking example
-========================================================
-
-Prerequisites
--------------
-
-Acts must be build with activated examples and Pythia8 support
-(``ACTS_BUILD_EXAMPLES_PYTHIA8=on``) to enable the fast simulation. ``<build>``
-is used to identify the path to the build directory.
-
-We assume that you have generated a simulation dataset based on the TrackML detector as described in
-:ref:`simulate-TrackML`. A good example dataset would be e.g. a ttbar sample with pileup 200 in a 2T magnetic field. Suppose the generated ttbar sample is available at ``data/sim_trackML/ttbar_mu200``.
-
-Run the CKF tracking
---------------------
-
-Run the CKF tracking tool that reads the simulation output (truth hits and truth particles), creates smeared
-measurements from the true hits, creates seeds (i.e. starting track parameters) from the pre-selected truth particles, 
-and run the CKF which will perform the track finding and track fitting simultaneously:
-
-Currently, there are two configurable criteria to select compatible source links on a surface with track parameters in CKF:
-
-* Global maximum chi2 of Kalman filtering. This could be set up via ``--ckf-selection-chi2max``
-* Global maximum number of measurements on a surface. This could be set up via ``--ckf-selection-nmax`` 
-
-The digitization of the truth hits must also be configured. Since the command-line configuration of this step can get unwieldy,
-an example JSON configuration file for the smearing digitizer is provided with the source code.
-The detector volumes and layers used in the space point maker are also configured using another example JSON file in the source code.
-
-.. code-block:: console
-
-   $ <build>/bin/ActsExampleCKFTracksGeneric \
-       --input-dir=data/sim_trackML/ttbar_mu200 \
-       --bf-constant-tesla=0:0:2 \
-       --ckf-selection-chi2max 15 \
-       --ckf-selection-nmax 10 \
-       --output-dir=data/reco_trackML/ttbar_mu200 \
-       --digi-config-file <source>/Examples/Algorithms/Digitization/share/default-smearing-config-generic.json \
-       --geo-selection-config-file <source>/Examples/Algorithms/TrackFinding/share/geoSelection-genericDetector.json
-       
-In default, the starting track parameters estimated from reconstructed seeds by the seeding algorithm are used to steer the CKF. Alternative options are using properly smeared track parameters of truth particles and using track parameters estimated from truth tracks, which can be configured by the options ``--ckf-truth-smeared-seeds`` and ``--ckf-truth-estimated-seeds``, respectively.
-
-The magnetic field setup should be consistent between simulation and CKF tracking.
-
-Look at the CKF tracking performance
-------------------------------------
-
-The CKF tracking will generate a root file named ``performance_ckf.root`` (the name is currently not configurable via the command line) in the ``data/reco_trackML/ttbar_mu200``.
-This file includes a few efficiency plots showing the CKF efficiency, fake rate, duplication rate and other plots showing detailed reconstruction info etc.
-
-Example plots to show the CKF efficiency, fake rate and duplication rate for the ttbar sample generated above:
-
-.. image:: ../../figures/performance/CKF/trackeff_vs_eta_ttbar_pu200.png
-   :width: 300
-
-.. image:: ../../figures/performance/CKF/fakerate_vs_eta_ttbar_pu200.png
-   :width: 300
-
-.. image:: ../../figures/performance/CKF/duplicationrate_vs_eta_ttbar_pu200.png
-   :width: 300
diff --git a/docs/examples/howto/run_fatras.rst b/docs/examples/howto/run_fatras.rst
deleted file mode 100644
index b3ab3be01e4..00000000000
--- a/docs/examples/howto/run_fatras.rst
+++ /dev/null
@@ -1,174 +0,0 @@
-.. _simulate-TrackML:
-
-Run the FAst TRAck Simulation
-=============================
-
-Prerequisites
--------------
-
-Acts must be build with the ``ACTS_BUILD_EXAMPLES=on`` option to produce the
-Fatras simulation executables. With this option alone, Fatras can be run for
-the generic detector using a particle gun or externally generated particle
-input data.
-
-Additional options might be needed to enable different generators or detectors.
-The ``ACTS_BUILD_EXAMPLES_PYTHIA8=on`` option enables Pythia8-based event
-generator executables. To be able to run e.g. DD4hep-base detectors, the
-``ACTS_BUILD_EXAMPLES_DD4hep=on`` option must be set. The full list of
-available options is available in the *Getting started* guide.
-
-In the following, it is assumed that Acts was build with Pythia8 support as
-described above in a separate build directory ``<build>``.
-
-Generate particle truth information
------------------------------------
-
-Before running the fast simulation, a truth dataset needs to be generated. The
-simplest option is to use the particle gun, which generates particles
-uniformly distributed within the given ranges. The particle gun does not
-implement a physics process but is useful e.g. single particle studies.
-
-The following command will generate 100 events with four (anti-)muons in
-each one and write the data as CSV files into the ``data/gen/four_muons``
-directory.
-
-.. code-block:: console
-
-   $ <build>/bin/ActsExampleParticleGun \
-       --events=100 \
-       --output-dir=data/gen/four_muons \
-       --output-csv \
-       --gen-phi-degree=0:90 \
-       --gen-eta=-2:2 \
-       --gen-mom-gev=1:5 \
-       --gen-pdg=13 \
-       --gen-randomize-charge \
-       --gen-nparticles=4
-
-The muons are generated within the given kinematic range, but are independent
-from each other. With the particle gun, all particles always originate from
-a single common vertex. With the default settings, the vertex will always be
-at the origin. Additional options allow to smear the vertex positions. The
-full list of options is available via
-
-.. code-block:: console
-
-   $ <build>/bin/ActsExampleParticleGun -h
-
-To generate more realistic truth datasets you can use the Pythia8-based
-generator. When generating particles with Pythia8, the event is build from
-a fixed number of hard scatter interactions and additional pileup interactions.
-The number of pileup interactions is drawn from a Poisson distribution.
-The following commands will generate proton-proton collisions with a
-center-of-mass energy of 14TeV that produce a top-pair from the single hard
-scatter interaction and additional 140 (on average) pileup interactions using
-the default soft QCD process. The output is written as CSV files in the
-``data/gen/ttbar_mu140`` directory.
-
-.. code-block:: console
-
-   $ <build>/bin/ActsExamplePythia8 \
-       --events=100 \
-       --output-dir=data/gen/ttbar_mu140 \
-       --output-csv \
-       --rnd-seed=42 \
-       --gen-cms-energy-gev=14000 \
-       --gen-hard-process=Top:qqbar2ttbar=on \
-       --gen-npileup=140
-
-A full list of options and their default values is available via
-
-.. code-block:: console
-
-   $ <build>/bin/ActsExamplePythia8 -h
-
-Simulate a TrackML-like detector
---------------------------------
-
-There is one simulation executable for each type of detectors. For
-TrackML-like datasets, the *Generic* detector must be used. The simulation
-requires particle truth information as input. This can be either generated
-on the fly using a particle gun or read from files that were created
-separately (as discussed above). For each input particle, the fast
-simulations propagates it through the detector. At each surface, particle
-interactions are simulated using parametric models and potential hits are
-registered.
-
-The following command simulates 100 events for the generic detector in a 2T
-magnetic field and writes the generated events as CSV files into the
-``data/sim_generic/single_muon`` directory. The particle truth is
-generated on-the-fly using the integrated particle gun; by default single
-muons in a reasonable kinematic range are generated.
-
-.. code-block:: console
-
-   $ <build>/bin/ActsExampleFatrasGeneric \
-       --output-dir=data/sim_generic/single_muon \
-       --output-csv \
-       --events=100 \
-       --bf-constant-tesla=0:0:2
-
-For each event, the following files will be created
-
--   ``event<number>-particles_initial.csv``
--   ``event<number>-particles_final.csv``
--   ``event<number>-hits.csv``
-
-where ``<number>`` is the event number. The first two files contain the
-initital and final states of simulated particles. The
-simulated particles can differ from the generated input particles: particles might not have been
-simulated due to kinematic cuts or additional particles might have been
-generated due to interactions. The hits describe the simulated detector readout.
-
-To use some of the previously generated truth datasets, the ``--input-dir``
-option must be set. The following command reads the previously generated
-top-pair sample with some additional selections cuts on the generated
-particles.
-
-.. code-block:: console
-
-   $ <build>/bin/ActsExampleFatrasGeneric \
-       --input-dir=data/gen/ttbar_mu140 \
-       --output-dir=data/sim_generic/ttbar_mu140 \
-       --output-csv \
-       --select-eta=-3:3 \
-       --select-pt=0.5: \
-       --remove-neutral \
-       --bf-constant-tesla=0:0:2 
-
-The output file structure will be the same as discussed above.
-
-Simulate a DD4hep based detector
---------------------------------
-
-Similar to the simulation of the generic detector, another example detector called *Open Data Detector* (ODD) based on the DD4hep description can be simulated with the ``ACTS_BUILD_DD4HEP_PLUGIN`` option enabled. For the DD4hep based detector, a xml file for the geometry description must be specified by the option ``--dd4hep-input``. In addition, a material mapping file must be provided via the option ``--mat-input-file`` in order to take into account the material effects in simulation. 
-
-The following command simulates 100 single muon events for the ODD in a 2T magnetic field.
-
-.. code-block:: console
-
-   $ <build>/bin/ActsExampleFatrasDD4hep \
-       --dd4hep-input <source>/thirdparty/OpenDataDetector/xml/OpenDataDetector.xml \ 
-       --mat-input-type file \
-       --mat-input-file <source>/thirdparty/OpenDataDetector/config/odd-material-mapping.config \
-       --output-dir=data/sim_ODD/single_muon \
-       --output-csv \
-       --events=100 \
-       --bf-constant-tesla=0:0:2
-
-The following command simulates the top-pair events based on the previously generated
-top-pair sample for the ODD in a 2T magnetic field.
-
-.. code-block:: console
-
-   $ <build>/bin/ActsExampleFatrasDD4hep \
-       --dd4hep-input <source>/thirdparty/OpenDataDetector/xml/OpenDataDetector.xml \ 
-       --mat-input-type file \
-       --mat-input-file <source>/thirdparty/OpenDataDetector/config/odd-material-mapping.config \
-       --input-dir=data/gen/ttbar_mu140 \
-       --output-dir=data/sim_generic/ttbar_mu140 \
-       --output-csv \
-       --select-eta=-3:3 \
-       --select-pt=0.5: \
-       --remove-neutral \
-       --bf-constant-tesla=0:0:2
diff --git a/docs/examples/howto/run_seeding.rst b/docs/examples/howto/run_seeding.rst
deleted file mode 100644
index e770843d36a..00000000000
--- a/docs/examples/howto/run_seeding.rst
+++ /dev/null
@@ -1,73 +0,0 @@
-Run the seeding example
-=======================
-
-Prerequisites
--------------
-
-ACTS needs to be built with ``ACTS_BUILD_EXAMPLES=ON`` to enable this example.
-Before running the seeding example, you have to prepare a simulated dataset. 
-The event generation and fatras simulation are explained in :ref:`simulate-TrackML`.
-
-
-Run the seeding example
------------------------
-
-
-Suppose the generated ttbar sample is available at ``data/sim_generic/ttbar_pu200``.
-The seed finding example reads the fatras simulation output and creates smeared measurements from the truth hits.
-After that, it creates space points from the smeared measurements, and the seed finding algorithm is performed.
-The following parameters for the seed finding are set in ``/acts/Examples/Run/Seeding/Common/SeedingExample.cpp``.
-
-.. code-block:: console
-
-  seedingCfg.rMax = 200.;
-  seedingCfg.deltaRMax = 60.;
-  seedingCfg.collisionRegionMin = -250;
-  seedingCfg.collisionRegionMax = 250.;
-  seedingCfg.zMin = -2000.;
-  seedingCfg.zMax = 2000.;
-  seedingCfg.maxSeedsPerSpM = 1;
-  seedingCfg.cotThetaMax = 7.40627;  // 2.7 eta
-  seedingCfg.sigmaScattering = 5;
-  seedingCfg.radLengthPerSeed = 0.1;
-  seedingCfg.minPt = 500.;
-  seedingCfg.bFieldInZ = 0.00199724;
-  seedingCfg.beamPosX = 0;
-  seedingCfg.beamPosY = 0;
-  seedingCfg.impactMax = 3.;
-
-
-You can run the seeding example with a command like this:
-The detector volumes and layers used in the space point maker are configured using a json file in the source code.
-
-.. code-block:: console
-
-   $ <build>/bin/ActsExampleSeedingGeneric \
-	--input-dir=data/sim_generic/ttbar_pu200 \
-	--output-dir=output_generic_ttbar_pu200 \
-        --bf-constant-tesla=0:0:2 \
-	--digi-config-file <source>/Examples/Algorithms/Digitization/share/default-smearing-config-generic.json \
-        --geo-selection-config-file <source>/Examples/Algorithms/TrackFinding/share/geoSelection-genericDetector.json
-
-After running this example, you should see something like this:
-
-.. code-block::
-   
-   SeedingPerfo   INFO      Efficiency (nMatchedParticles / nAllParticles) = 0.910987
-   SeedingPerfo   INFO      Fake rate (nUnMatchedSeeds / nAllSeeds) = 0.586774
-   SeedingPerfo   INFO      Duplication rate (nDuplicatedMatchedParticles / nMatchedParticles) = 0.778491
-   SeedingPerfo   INFO      Average number of duplicated seeds ((nMatchedSeeds - nMatchedParticles) / nMatchedParticles) = 7.59991
-
-This output shows the efficiency, fake rate, and duplicate rate for the selected particles.
-The example also generates output root files in the output directory.
-In ``performance_seeding.root``, you can find the efficiency plots.
-The plots below are examples of the efficiency plots produced using the ttbar sample with 200 pile-up vertices.
-
-.. image:: ../../figures/performance/seeding/seeding_eff_vs_pt.png
-   :width: 300
-
-.. image:: ../../figures/performance/seeding/seeding_eff_vs_eta.png
-   :width: 300
-
-
-
diff --git a/docs/examples/howto/run_sycl_seed_finding.rst b/docs/examples/howto/run_sycl_seed_finding.rst
deleted file mode 100644
index b1473df5853..00000000000
--- a/docs/examples/howto/run_sycl_seed_finding.rst
+++ /dev/null
@@ -1,111 +0,0 @@
-Run the SYCL seed finding tests
-===============================
-
-List available devices
-----------------------
-
-We can list available platforms and devices with **clinfo**:
-
-.. code-block:: bash
-
-    [bash][atspot01]:build > clinfo
-        Number of platforms                               3
-        Platform Name                                   Intel(R) OpenCL
-        Platform Vendor                                 Intel(R) Corporation
-        Platform Version                                OpenCL 2.1 LINUX
-        ...
-
-This is useful to decide which device we want to generate binaries for (because we need to give that to CMake). Note, that this would not only list OpenCL, but also CUDA devices.
-
-We can install *clinfo* from our packet manager.
-
-Compiler
---------
-
-The SYCL seed finding implementation includes extensions from DPC++, so the code should be compiled with a dpcpp compiler. It can be cloned and built from the Intel LLVM `github`_ repository, or it could also be downloaded and installed from the `oneAPI`_ website.
-
-.. _github: https://github.com/intel/llvm/
-.. _oneAPI: https://software.intel.com/content/www/us/en/develop/articles/intel-oneapi-dpcpp-compiler-release-notes-beta.html
-
-CMake should inform us whether our compiler is SYCL compatible.
-
-.. code-block::
-
-    -- Checking if /atlas/software/intel/clang/12.0.0-2020-08-24/x86_64-ubuntu1804-gcc8-opt/bin/clang++ is SYCL capable... success
-    -- Checking for available SYCL target(s)...
-    --   - Found target: nvptx64-nvidia-cuda-sycldevice
-    -- Checking for available SYCL target(s)... done
-    ...
-
-Building with CMake
--------------------
-
-During the CMake configuration the flag ``ACTS_BUILD_PLUGIN_SYCL=on`` needs to be set. CMake will check whether our compiler is SYCL compatible and will look for available SYCL target architectures.
-
-By default, SPIR 64-bits targets are looked for, but this can be configured with the ``SYCL_POSSIBLE_TARGETS`` variable.
-For example, to target CUDA backends, we should set this variable to ``nvptx64-nvidia-cuda-sycldevice``.
-
-.. code-block:: cmake
-
-    # Figure out which SYCL target platforms are available.
-    set( SYCL_POSSIBLE_TARGETS "spir64-unknown-unknown-sycldevice"
-    ...
-
-Also, by setting the variable ``SYCL_SEARCH_SUPPORT_LIBRARIES`` it is possible to specify support libraries or object files that are needed for execution on a specific target. Missing object files cause a runtime error.
-
-Trying the code
----------------
-
-We can build the unit test ActsUnitTestSeedFinderSycl for this purpose (actually, this is not a unit test).
-The test compares the results of the CPU and SYCL seed finding algorithm in terms of speed and precision.
-
-It takes the following command-line options:
-
-.. code-block:: bash
-
-    Allowed options:
-    -h [ --help ]           Print usage message.
-    -f [ --FILE ] arg       Provide path for input file.
-    -n [ --NUM ] arg (=500) Number of groups to iterate in seed finding.
-    -d [ --DEVICE ] arg     Provide a substring of the preferred device.
-    -l [ --LIST ]           List available SYCL platforms and devices.
-    -G [ --GPU ]            Execute code only on gpu. Default is 0.
-    -a [ --ALL ]            Analyze all groups. Default is 0.
-    -m [ --MATCH ]          Count seed matches. Default is 0.
-
-We can select the preferred device by the -d option, or we could also set the ``SYCL_BE`` environment variable.
-
-By setting the environment variable ``SYCL_BE`` we can alter the behavior of the SYCL ``default_selector``
-For example by setting it to ``PI_CUDA`` it forces the usage of the CUDA backend (if available).
-Similarly ``PI_OPENCL`` forces the usage of the OpenCL backend.
-
-We have to provide an input file with the -f flag.
-The input file should have a predefined format:
-
-.. code-block:: bash
-
-    [bash][atspot01]:build > head /atlas/acts_data/atlas_seeds/pu200/evt10.txt 
-        lxyz 1 -35.4702 -10.973 -346 0.05 0.1
-        lxyz 1 -37.5198 -12.2698 -383 0.05 0.1
-        lxyz 1 -39.7144 -13.9292 -423 0.05 0.1
-        lxyz 1 -41.723 -16.0801 -470 0.05 0.1
-        lxyz 1 -44.332 -18.1633 -525 0.05 0.1
-
-Numbers correspond to layer, x, y, z coordinates, R, and Z variances (?).
-
-In the end, we should see something like this:
-
-.. code-block:: bash
-
-    [bash][atspot01]:build > SYCL_BE=PI_CUDA bin/ActsUnitTestSeedFinderSycl -f /atlas/acts_data/atlas_seeds/pu200/evt10.txt -m
-        11:48:57    QueueWrapper   INFO      Running on: GeForce RTX 2060
-        read 360734 SP from file /atlas/acts_data/atlas_seeds/pu200/evt10.txt
-        Preparation time: 0.637518
-        Analyzed 260 groups for CPU
-        Analyzed 260 groups for SYCL
-
-        ------------------------- Time Metric -------------------------
-                     Device:        CPU       SYCL  Speedup/ Agreement
-                   Time (s):  13.316532   1.733498            7.681883
-                Seeds found:     171516     171516           99.950447
-        ---------------------------------------------------------------
diff --git a/docs/examples/howto/run_truth_tracking.rst b/docs/examples/howto/run_truth_tracking.rst
deleted file mode 100644
index c09a08b74eb..00000000000
--- a/docs/examples/howto/run_truth_tracking.rst
+++ /dev/null
@@ -1,68 +0,0 @@
-.. _truth-fit-TrackML:
-
-Run the truth tracking examples
-===============================
-
-Prerequisites
--------------
-
-Acts must be build with activated examples and Pythia8 support
-(``ACTS_BUILD_EXAMPLES_PYTHIA8=on``) to enable the fast simulation. ``<build>``
-is used to identify the path to the build directory.
-
-We assume that you have generated a simulation dataset based on the TrackML detector as described in :ref:`simulate-TrackML`. A good example dataset would be e.g. a ttbar sample with pileup 200 in a 2T magnetic field. Suppose the generated ttbar sample is available at ``data/sim_trackML/ttbar_mu200``. 
-
-Run the truth tracking
-----------------------
-
-Run the truth tracking tool that reads the simulation output (truth hits and truth particles), creates smeared
-measurements from the true hits, creates seeds (i.e. starting track parameters) from the truth particles, builds truth tracks (i.e. uses the truth
-information to group simulated hits into tracks) and fits them. 
-
-.. code-block:: console
-
-   $ <build>/bin/ActsExampleTruthTracksGeneric \
-       --input-dir=data/sim_trackML/ttbar_mu200 \
-       --digi-config-file <source>/Examples/Algorithms/Digitization/share/default-smearing-config-generic.json \
-       --bf-constant-tesla=0:0:2 \
-       --output-dir=data/reco_trackML/ttbar_mu200
-
-The ``--digi-config-file`` specifies the path for the digitization configuration file. The magnetic field setup should be consistent between simulation and truth tracking. 
-
-Look at the truth tracking performance
---------------------------------------
-
-The truth tracking will generate three root files (the name of those root files are currently not configurable via the command line) in the ``data/reco_trackML/ttbar_mu200``:
-
-*  ``tracks.root`` This includes a tree with one entry representing one trajectory. From this file, one could check the information of every measurement track state on the trajectory.
-*  ``performace_track_finder.root`` This includes a tree showing performance of the truth track finding.
-*  ``performance_track_fitter.root`` This includes a few histograms showing the residual and pull of the fitted perigee track parameters and efficiency plots showing the fitting efficiency etc.
-
-Example plots to show the fitting efficiency versus eta and pT for ttbar sample generated above:
-
-.. image:: ../../figures/performance/fitter/trackeff_vs_eta_ttbar_pu200.png
-   :width: 300
-
-.. image:: ../../figures/performance/fitter/trackeff_vs_pT_ttbar_pu200.png
-   :width: 300
-
-Example plots to show the average number of measurements and holes versus eta for ttbar sample generated above:
-
-.. image:: ../../figures/performance/fitter/nMeasurements_vs_eta_ttbar_pu200.png
-   :width: 300
-
-.. image:: ../../figures/performance/fitter/nHoles_vs_eta_ttbar_pu200.png
-   :width: 300
-
-To draw the resolution (residual and pull) of fitted perigee track parameters for e.g. ttbar sample, one could use:
-
-.. code-block:: console
-
- $ root <source>/Examples/Scripts/perigeeParamResolution.C'("rec_ttbar_pu200/performance_track_fitter.root")'
-
-``<source>`` here is used to identify the path of the source directory. 
-
-An example plot of the pull distribution of fitted perigee track parameters for the ttbar sample generated above:
-
-.. image:: ../../figures/performance/fitter/pull_perigee_parameters_ttbar_pu200.png
-   :width: 600
diff --git a/docs/examples/howto/setup_and_run_vertexing.md b/docs/examples/howto/setup_and_run_vertexing.md
deleted file mode 100644
index 04a34e96d72..00000000000
--- a/docs/examples/howto/setup_and_run_vertexing.md
+++ /dev/null
@@ -1,137 +0,0 @@
-(vertexing)=
-# ACTS Vertexing Tutorial - Example: Adaptive Multi-Vertex Finder (AMVF) - Pythia8
-
-This tutorial sets up and runs the ACTS Adaptive Multi-Vertex Finder on smeared ACTS Pythia8 truth tracks.
-*Note*: You have to have Pythia8 available on your machine for following this tutorial.
-
-## Prerequisites
-
-For setting up and building ACTS, please refer to the general how-to ACTS guide. For this example you will need to enable Pythia8 in the examples by adding
-```bash
--DACTS_BUILD_EXAMPLES_PYTHIA8=ON
-```
-to your cmake command.
-
-Note: Additionally adding
-```bash
--DCMAKE_BUILD_TYPE=Release
-```
-to your cmake command will significantly speed up the execution time of the vertexing example algorithm below, it will however slow down the compilation process.
-
-## Setting up an ACTS Adaptive Multi-Vertex Finder Algorithm
-
-A template algorithm file with an (almost) empty `execute()` method to be filled in the following is provided here:
-```
-../Examples/Algorithms/Vertexing/src/TutorialVertexFinderAlgorithm.cpp
-```
-Open the file in your editor and let's start setting up the AMVF. We will start setting up all necessary components in the `execute()` method.
-*Note:* You would normally **not** want to do all the following setup steps in the `execute()` method (that is run on every single event), but rather in e.g. the constructor. For the sake of this tutorial, however, everything will be set up and run in the `execute()` method.
-
-### Setting up required tools: Stepper and propagator
-
-We need the `Acts::Propagator` with the `Acts::EigenStepper`:
-```cpp
-// Set up EigenStepper
-Acts::EigenStepper<> stepper(m_cfg.bField);
-// Set up the propagator
-using Propagator = Acts::Propagator<Acts::EigenStepper<>>;
-auto propagator = std::make_shared<Propagator>(stepper);
-```
-
-### Setting up required tools for the vertex fitter
-
-Now, set up an impact point estimator...
-```cpp
-// Set up ImpactPointEstimator
-using IPEstimator = Acts::ImpactPointEstimator<Acts::BoundTrackParameters, Propagator>;
-IPEstimator::Config ipEstimatorCfg(m_cfg.bField, propagator);
-IPEstimator ipEstimator(ipEstimatorCfg);
-```
-... and track linearizer for helical track parameters:
-```cpp
-// Set up the helical track linearizer
-using Linearizer = Acts::HelicalTrackLinearizer<Propagator>;
-Linearizer::Config ltConfig(m_cfg.bField, propagator);
-Linearizer linearizer(ltConfig);
-```
-Now, for the sake of this example, let's specify a user-defined annealing scheme for the AVMF:
-```cpp
-// Set up deterministic annealing with user-defined temperatures
-std::vector<double> temperatures{8.0, 4.0, 2.0, 1.4142136, 1.2247449, 1.0};
-Acts::AnnealingUtility::Config annealingConfig;
-annealingConfig.setOfTemperatures = temperatures;
-Acts::AnnealingUtility annealingUtility(annealingConfig);
-```
-The AMVF strongly interplays with its dedicated vertex fitter, the *Adaptive Multi-Vertex Fitter*. Let's configure and set it up with the annealing utility defined above:
-```cpp
-// Set up the vertex fitter with user-defined annealing
-using Fitter = Acts::AdaptiveMultiVertexFitter<Acts::BoundTrackParameters, Linearizer>;
-Fitter::Config fitterCfg(ipEstimator);
-fitterCfg.annealingTool = annealingUtility;
-Fitter fitter(fitterCfg);
-```
-
-### Setting up required tools: Vertex seed finder
-
-The last tool we need to set up (before finally setting up the AMVF) is a vertex seed finder:
-```cpp
-// Set up the vertex seed finder
-using SeedFinder = Acts::TrackDensityVertexFinder<Fitter, Acts::GaussianTrackDensity<Acts::BoundTrackParameters>>;
-SeedFinder seedFinder;
-```
-### Setting up the AMVF tool
-
-Now we are ready to set up the Adaptive Multi-Vertex Finder. ACTS vertex finders are templated on the vertex fitter and vertex seed finder type:
-```cpp
-// The vertex finder type
-using Finder = Acts::AdaptiveMultiVertexFinder<Fitter, SeedFinder>;
-```
-We configure the vertex finder in such a way that we do *not* use a beam spot constraint here:
-```cpp
-Finder::Config finderConfig(std::move(fitter), seedFinder, ipEstimator, linearizer);
-```
-Create the AMVF instance and a finder state to be passed to the `find()` method below:
-```cpp
-// Instantiate the finder
-Finder finder(finderConfig);
-// The vertex finder state
-Finder::State state;
-```
-Lastly, we need to provide vertexing options. Here, we could e.g. set a beam spot constraint to the vertexing.
-```cpp
-// Default vertexing options, this is where e.g. a constraint could be set
-using VertexingOptions = Acts::VertexingOptions<Acts::BoundTrackParameters>;
-VertexingOptions finderOpts(ctx.geoContext, ctx.magFieldContext);
- ```
-### Deploying the vertex finder on the track collection
-
-Now we're ready to actually use the AMVF tool that we have set up above to find vertices on our input track collection. The `find()` methods on ACTS vertex finders return an `Acts::Result` object that we can use to check if any errors occurred and to retrieve the vertex collection:
-```cpp
-// Find vertices
-auto res = finder.find(inputTrackPointers, finderOpts, state);
-
-if (res.ok()) {
-  // Retrieve vertices found by vertex finder
-  auto vertexCollection = *res;
-  ACTS_INFO("Found " << vertexCollection.size() << " vertices in event.");
-  
-  unsigned int count = 0;
-  for (const auto& vtx : vertexCollection) {
-    ACTS_INFO("\t" << ++count << ". vertex at "
-                   << "(" << vtx.position().x() << "," << vtx.position().y()
-                   << "," << vtx.position().z() << ") with "
-                   << vtx.tracks().size() << " tracks.");
-  }
-} else {
-  ACTS_ERROR("Error in vertex finder: " << res.error().message());
-}
-```
-For reference, the full tutorial code can also be found in a file called `AdaptiveMultiVertexFinderAlgorithm.cpp` in the same directory as `TutorialVertexFinderAlgorithm.cpp`.
-
-## Running the example algorithm
-
-In your build directory, recompile and run the example on three pileup-50 pythia events to get your first ACTS vertices:
-```
-make -j4
-./bin/ActsTutorialVertexFinder --evg-pileup 50 -n 3
-```
diff --git a/docs/examples/material_mapping.md b/docs/examples/material_mapping.md
deleted file mode 100644
index 0c7d5378de3..00000000000
--- a/docs/examples/material_mapping.md
+++ /dev/null
@@ -1 +0,0 @@
-# Material mapping
diff --git a/docs/fatras/fatras.md b/docs/fatras/fatras.md
index d7193cc0db3..10ac1719b44 100644
--- a/docs/fatras/fatras.md
+++ b/docs/fatras/fatras.md
@@ -1 +1,8 @@
 # Fatras
+
+:::{todo}
+Write fatras documentation
+:::
+
+## Supported interactions
+## Use-cases & counter indications (when to use G4)
diff --git a/docs/figures/CuboidVolumeBounds_decomp.gif b/docs/figures/CuboidVolumeBounds_decomp.gif
deleted file mode 100755
index 7372822e783d7edd5899c643f10325b152d73718..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 6826
zcmd6rS5VV|_vOC{2nnHyh;$>pY6L_Ogn)Deqo6dwP((lwL^=qecL=>h=pZfh4xva1
zy^07Jigf8JMalkt|Jj+Hec1Os4|nE1-81LDocXA0s>#TjFN2Oi>i~ekU<d@l!NCCv
zg(4FOWDEuX05XY0Mx&8PB#A`A;c(s4o8*Io@$qpo4yXRHIk;rp$;pZQpA`UTp6255
zct%D>G9HgcqsiF+>hRZDLB|3afq=u|!fz^;w@=7UPC+(U1OmbKvY3oSlHu^$!4)zJ
zCF5M{mPNEq=rsuINUWVDGcrzo-|Ma$IQUFV%<m)FxwwA(r2aCk6N&702~)Q(Aw76h
zW90nWxj^Ve77mTBu??8$9F0XHT^-VcWY80ey4{H-wWZzPkw^?0jrq?Z@_#)3f2~_*
zl>g&T?7#EBKLM!87_ET7px}_uu<(e;sOXqjY+QUoVp4KSYFc_E49L#G<>uuV6c!bi
zlzu8^%c!ivSJ%|m)i*Ro0!^*0Ep45IuI`@R&oLc+gK-1Ik<qd7iJoCCFnDrodhXl8
z;?j4mVHye$sds+8_Dc{4O#qC3>*$y`4g5H1+dRvdW@8Gt-L$HXhl_ik(sJvcMsVJu
zzL{vqO2FrR)`HyWn=igPdBu)T%*t@Qx<K<0+Y{@R5{Wnp3O*X~0mkaWkw{_3XBMRi
zSs;oXN@x>+FMjGfOlc4IbTQIX<@1%eer`^hDqHffcwSJyF_d#R`0|^Uo5`1&;L)Yw
zgX0Y(RFynIbSQFrx0sxzVAXWL(NVfHdT;(QmJz@FVFH5oK!7qx$w3U-*#bJ0pjuzv
zCrjmbj02%O>@uS-Q){=3Vjav+qs(1ijTBotCW;IF(wwXNU|AEL<gU5U68PlkUt*IQ
zsXO6jf*afM&LlDaLsAGP<1lid@a+?hpTL!g$_?x9x|ipobj;i`U)a!9!tG@%Lpe`g
zU1BKLOw-(d_y>gl62F1~0Hs?JW_n;Sqk(U$rXI#sn%@x3L;ai2T!z-JCP$P3JU0;>
zqtCjGQF3U?3Qu=o%~pfcOC<S^SF7{5vq`f?M@-^UA4diq@L6ce)8|>bJTeQglv1U+
zW<`#T{Od6huRLqRE2XZSuyzL}Q5u#&`<ksVG5MvYW|AM<8vm`kOx>@Q-uOb-b?KEg
zP#M_rG={8q9m3(M3D_;#oEnnRn{*mzdT}-uU=Po6nXuf%-5hNa%<K7VGz6lQx^Md+
zmN?Cq>#k)iT&TNfGek*;NRO1w$~&=Dt(er<=8aI!+ZNzKpXiiVzJrRC<%P(;%}chM
z1VHR1_ccHaHh|#$Htv<xswI_gJ9z)=kx(!*3T3MJ&Cq+G%1xPfuYRu5&Q5?KmGo1z
zUcq^f?}xPHot7;DrYhb>>B&m3imtcs@SW3dhubIDhXy*LPs#>5VPCZo2r7m^1eu3c
zZ&LFkr~7WTAk=49Q<U==_`NvW4d?efcetP3MTlD3>k_+OHs<yOXWGL?w0g_;%f@x1
z=7%4C{Y$L4rNY=n!-zx&Ud=KRbLnM%rX4jl<)5GrTr;+E8H~iCl&@H+AHaGH%S`H}
zY~TE&lXQw3zxU{sqq8XW)hJUCjL`e-H_w`J^pEMrgU97?N2tP+MPY#ecPJwQr34FT
z!UVvYgwF2^-081ro;S*sYE+JTqrAQv2g?If2Ou%Z+j6T%vI6u`^peX@J59p?aqo)d
ziD29)aI3s=6xbE|CgCl>)T=jq1iPlAvENZe*#_?x?FLhPyP*p^iAE{5lb?5CZnn<`
zX`qz=mPGvr0u0vVH@GIfB8_9M**j6ob@VF)!O^LKizq3I0lKm4pw^)9;V+7+Vi=#A
zshoc<#R(weZb~^J<s#{UE_$znK+XaJj1l8c0kHtH+hA&H>Y-HJx38Xl3x;uMbY&Rg
znXUo3^zNHVG?_@sGB!#uO0`FOn31W|3rz`SesH3+3Y6GI5z7D239s7+i`DgBeRZ{G
zUlY$g>8(bgoG<M3^zO}muVual2#kL;AiD6=vZR<~hU91<AS0L9){z=>y8|4P5uYzf
zPZBd+!1D%x*7$licp%owasKu^QV<|pSa(ps)qkx7%}P)|x=U6!cL}kudanU`pqwyf
zk;W_RPt?(3O6V+u^BSjVshq|o<s>G+RgL<!8-n=j%2k*Qn$-nf1o;i+>fX6-D5XM~
zz|tsI^b^ZORPyb|R@dd;$~J=C=ee6QGyOwyJn*x<gkEwWsYpDp6ylowA%(a(<|lTh
zYxtWs^BBD*7uKxfL!?MEDwvcA<{zTtLxOp<OO&;*O6bu7xg`f1E8SnC<UhsX<|#}5
za1J~Xx19>#$rDsFFP)fMtV&RPBq*O`KEV@nlEP}iAo$=@e?sE41Nd_hm${do1^(JA
zk*(6<y4Py2sO}Zn917@~(@bVY=o{29e?s_*h<aB_v5Av)ik><|=x1!|LA7+Y)T`{G
z%BfBY)swc7bV|=-jejMLA$HCh?3heTo)>?T-+7wB{-u64zIa5w)U26k@Mhq;i_MR1
zQ?krd*KAUr*sn5CkZ4N7>`8TSMTr%!=GTJBI%)stpeysmL3Fr8JKdRBSveDyp@0{K
zSk?#%F-(pbdKIr7Y^UaZG=ryiEzi>dpbBNid6h33`RFRdpJX8B)K(~%2TkoFji1a)
z+^hQVQIt;_fnh+n+w?68J6E(C=suYJn1CWsQ=<LxR(lN@(U#7yi4(^>&P@5&gKQl*
z%vzkKD?Yq;FsOnV^z{A71Ck>hGhhqvAlDl$D&CO;CU{7nSyIYBV-6ho%MF*LrCTZ8
z5I%>*<$mMTme3NsGuz#f=#Z0cezpDZSkY@MqlRq}2qcw;N$pj|Uscy;Z<}<Q%rM@`
z6TdO{K2meRKp^)10LX6R3JV$o=${c^jMjhv%#Yh|&xXwCB~!Z=k|i?EhHZ3f)4vQ`
zOYNt2-k~x8=PWE&KnS245Fjq{<&s+64~p%b45<gWK<fWgp_?a4Oe!8haCoi)ooPvd
z;9>+vk20_wOdSB-3FF(B^&Hy-AV@|Em5i29McNgsV4rKh6%w0#)?Ij$Y3*Kzu~TxD
z1Yh4;c+;kDDO_(_U#^-NWwOyiP;1zFNJR#A=mfo0TZOXWQ6n(rm}hhC4Z=`~@m+`_
zM`9-i^dk}JfR>8<(sO%|3Lu!WTe9@vNdN?nddKgCSrR2&sc~!HvVT?34iXAoVcc=F
z`4T`O0_UitdkW&0`m0|evgX%mij~{&BpJW1@3Nf$*E|Qnx6n;Jai&fIhO1zfQ>m8y
zjIV~AII80iB#Z|myP^uWom}!5+<L!(b@g7^7ibox#{iV6*mvsHE<7I8K>V$hvfGQz
zNj6F@`Kx?eR8MIfl-iv28aS^#S3IAI&O51l+}pROw*N(N0-y_exJjqmPbCc}eK}A0
zap0>$ah?FKF8lbIlsa(E<Nu!QsNMb;y*~yehP!WgQSi_U$wvt*xVj}B9+>?J`TWa1
zs>Yq`u=>!)BG-S5!R7&5UcYqH>jW>jVqiNP$xQ&4{hk<T#>7Ct^l~{~m<zoIb@f$m
zb3EDAV#dX{^~)nD0St_fwDHpY;lk%|Z=QIrol$hhG5^hf%Wup!FI%KZ-m$Qs?(|N!
zf(pNMro8r3I?pyjYx@jtdhK3tUoL$Ae(I`__M74#%X*4m&;~#Q&;+6|IZha=Fd1MR
zMU#r5h4^b>Fxdx~>#Y7aWc*<z{!AMF10;WzQ~zuPuy@5bblLBy9tLVssk45C=Xv^2
zjYDY8aU0{;iU##1l6`~0f#-sOzu&+_H5eu5p2()sKN9kLFL(`#1#UWlk{E-Cl7Pq`
z&zSDO&rU)6t{=r%m=b{C`f+LXO<l@<Hp97(!3dT(Qg8!GPM|(eRYOOiBsgN+Ok9Xr
z+5@I1<C%LDqMXX{S|%h2XXa^0=gt~jKj~$m5g30M+WZ_sLGsaVg4jWHeC9%qv0=gk
zzKW+o!Kv?BErPl8!ksms39Lf8_mxPP@X0TJ8LTE*o2p43(gdbR%YLs4nYUGjFb-5`
zJ&RP`>Br)(un@uUW+B-4hQ%B%qPssL-vd(nI`rEOB@PVVGC1Pe_0S9T>pRb*suA>^
zVXPClC@&3iNTU$*)5B|r?vE*squ0LN=-#vsgaaEkz`b1gx=^oCcnq~Q>;3?m;Sgl)
z7TawVo$PUs(w31!(w3$f%lRSV{Tt8?k`I6fK>d;N2Z}77!PFnHG=bvNIN&EC>Z~V*
z%P8LZG?;>5NtTLdvyH#K^`eOca0*8TK8nBNnQ$2fqZyBH42_o#Pe4Kw99^RR{!y1?
zOYCvxKZnHP@rfF?H|jBg@@x^6q{JuCq&b^JMbD&{vglYo@2ODei?2zBrBF-H_;{ye
zE8!a#<{&-WAZyRWx21^QyJ6clD$cSgE~Tmz&ti%bQ@ol}67e@2p`o_WRDa>r1`Us}
zG;*qsCI{HUJ(>~tw;3QZl^PSSO~b?iea8GIH`zT@AT=#5bWkN}OS4EgEdn2DFRPue
znf^U7uy`<~rZl~^C-&z_I{qxhQ6}T93Zetg0G5cx+{$ce&ZsmB?_kULa4j>06dj!Q
z4rdf^R+E{aDKpwEH}Un&)Ymu%i>&6e=&x)}T|$t>QiKOMdzDA2%QKsLIeW`OXj?d4
zaSKMEeoC8`b8br$6rRacn`CBtt63`N@+<(b%ea44l+qYy&+~MaO&mtVJ@>#>TQjXN
z<uW~p{N|Z{9FWU4PY0Qby>*^z&@9nylgG!NsBj!Anx1z*P1+EWf7>qJPcrD<19JXm
zc$(0uEO$iyz2>a?`?*NFG=&x}Qi7Mdae-GiGP}P(ON3vtz~$+A0d0-yed|JfyMq3~
zMElx8*|frzT#ZQnBD4r+dclh~#zoB&TFRe`?1*V*>;-a6#VY4TR$V&mGa@KT)d8Dg
z-(}qaW^v@2JLyO9$GET%-rLu3=FWB{2Ik`4M8}fn3NK_ptVrPdWMs^F2~MU&V*s`?
zm+u&Xh!ioEP$|xBE@kn;CP$R!Y$rUL5Bwy;%WUk~I4+%HP*VGe2`4O&kx-i6QYIGg
z=^`wpo*la6@6#eu&T?0-`9bOPv-Gv;;$b_17HIhuwv>J?=#fgrOiO6>JQ*^0{;7_w
zGL}%{dR{TpRFQ<JFbYdoQc6t5RN9nQF5us-pF<YUD^oC4yNq{EXu^Km1vE0^e;Iqj
zq4>WK@VR`z%VQXoC|<Zpfo7+I*2HHS4&pb&7e%}T;ebRa?bV^e8?D?sBy0nsre{-&
zHzB5>2G1W^{g4+M{iu?By@nB1dlv?8)4Se=#tV<T5hHMAR5d(hwQ|~i0dNpl2uh_5
zgs9b|3DJtc^fg<(QePO$UeG`gbt)HrCK(k5+R<*Octsd&?7Uu&gZ8;euBDtJo10X;
zml4{#f#sqhnyFE`wL#sx(IYa}E3(eD73LtC=$Fyhi)wl|L~b<aC=Z3H`R~wt;K1#L
z!XnBVVk0B;-`?jzgSipSg(^(}8O`ZK4H=}{+@$(c4%dvG#sZGO@S)p~1EBO<Skh2+
z<wc7WTWj(G0KqoA@NN~BYiVh1?Qt^ffVI79iHL?(d=@S1mxB(<HAT-iT3oaRuryyD
zwGNksxp}wGeXE`wf=p=#ZyCc<w40Y(8<Shxi6-q)7ws{v9lMdO;i!&Mn$Dx0wiE3(
zEp(}pC@d<VbBMJwZwPXW07f9Z{=qteoJwnv0+i)}<!@V}0nl|ExPKP%LEsbZr|Ut}
zK#<*i*`D^#ULCbgfXcX(*h2U1OeZTnuq4KYM}@3RP3pQr)18*r5`h8VYJ`YLbSVn7
z)u3D@2!KXruU2_4S4tNboI)zojt<jv>B*813DJ~vq|2vN-nClPc2&LK9nJ`b;|N&%
zTm7g^c_o0y3CxYQ6B_SL$d__?+3zY3mOAJVvhJulaKjQnvg*BbZT&%nzJG^(VY49C
z$I_B-`eVwa6f;}TVKCo?9uYkFECkAq15sl8TEAYWCU`_(30TXryJ~~xyO915@@ZI+
zZMlJ=Z5qyTkpF@wb0#!t0a8W_Dw+cHXovbtU}7Y&7;0!mbRZr(6vGInB@CzHl+#uQ
z@lc_-KzY13F$Fiw4jum03Z3yGBgcmb$+(e*;gQQ$=xu;vi#FyA23@0VTHhrQ2Ku88
zMzI`Y#~1E%yO7^eO{bhg*<r(h<8J?G8_Bfe=ECDzcz5P;cdYApqfg4umk?^4N8aNk
zMy?4B1HzxOeyxm&pv>`U(Fyp&7#;`0jNYU`#n{SYh-Cp~t9!Hv*QD4;KM$ceM0SeP
zH1a|oqGG@}`8d6Ut%ZSh`hm{W_MguIPQVp-pOfdbT-M}6ok^6=7?skrzUd527K35?
zgt5cS2PPl!#d3>(GeQm(yIPGSTII_ZF*jCc?b|z|SS3GjeK|1+F%10Tw%BP7N&T2L
zYu(;-gqM|s<ZN&I)drI1yhldDN;0D9=KR}hav)!qb|TN%zlNBIzc+RZX|GLoQ^{$c
zV|!?6uQH!UH_1Y!QTlP7|DyqRZN9u>@>#G}E!Q{6MZLP9Zw(bw{J$Qzw|`ToLv8ad
z5a?$9@`m)AE<7KROdVJtR?G<JM@{@&coi)@Ek5VyvN-cmF7e}tSlCz3FUs@nZC@7`
zNm*mYo?pMd4cq>>B>1w@Xfbj1<C3a#_OFNE_bPY~O241}T&gNh`)N8lVYhV2HQdKe
zI-sq(vJ^_Q6oZ-i4y&AP3nx)M#8PrEFO8($=<pp5UoM~^>BO;T>3lELTvpwB%(%C_
z7QMo8Ill9CMZ~N{>>YVUA_Kz9y=?q`HK}4%hC5rT!%aSBxevN3tCOS1y;{hzR#vno
zGD`b+PwUCj+Irf`-|Ii_cG#=z-Fp$U_Dq<=G-eIWy>6kfZe_M^?YnN1y>8dBZojnt
z?sDCUd&5~_!^LdF&3B_JLs&O@<939y_vi+nh%aU@pAHKSP}mI1-i+wjjJg!yUfe7Q
zufUGtRv&D!ZC56b;x5v+Xwy3~b%nDpx4f9P^XLT%%(m}2Z<mb1KXq)cO>9?Ia^bmm
zChqRk`Lh1>r@4>MX}fJp!D!m3Tl$?9tO&nhQn}*61d>Iu^zSW)fWg-p2O-KooG*oh
zkkV;B%p)<&6*c4me%#M#?u}|DFh33~jRJFU!k6hcCMJikBEX!$s9^Qas|t7a6?lxe
zcU5Ex{wVD4T&{~w?Z?IMpTAqHh93wy4SpSEIO!nS@*cFx3zGNN{U{D+Xe+NUd`cBQ
z7~UNYe0b>4ArFo{WFs%OA&zc7Ip7~d3gtw=$JQmMkKpG=Z#z^as-Pc=D%30YotQz7
z&^E;^C-+_|TWB8J(W|S3QWUbBDBt;fV0zTZ{^d$E)IdxJb@P`<6-2Ky&gj*FMh>wR
zqbxGLY`{=9i2sF0sL1=InT{PlWBA>50Nfb)Eq8PGm7{AfR!za|x3wd!%@deM-5;M<
zORkO(zdPi64vv2uWB=?JpVs;Q@vEezdqu)39*6twn5c|9<wU9Ftc!R1ygP%@{v1z!
zcpBsvBKK-SLF!NZ_cNOgK5g@cR>t~5$MbB-dr*`d8#<+J`}~csKz(rF@ZN>Bt{}7U
zRh=P7=?c-*>nwImojL7qG{F8g_B7_^PM1|_`JLS_``csFKt-H##s1&9Cx0oH{*@`5
zU3+)o?~H1{yljg>ZH`@@ydwYhBcJAw&pXL~86f{}V4IPd^?w1|vhs@m18kd`TUy)N
zJN`GY?du;HBn}OakpD|;C#R-oX1~mRo&O(VOIlu8UHh@VvAMOqv-@*z|KRZG_~h5`
zKc{Es7k~d<k^u@DP7OS+D-d!`<mCW9w<na5S1VJaI`4BNtEAn+Ky`k9Ec{Ufr)EvT
zV1kg|r<a2@g+nO_OJb&GZP7@E%!loT!P?@n9AqF3msVZLM7~CXh$*qIbgCGYua!lV
zLQ(;SwRVfd`m!%o=$;5JZI)dONMD$W6+j}}>K&%kf_7NAO`93_=U<!LaD3Fh4_ufE
zHJL7VK^Us^qMG2VF0mZ2D4&>`HNWJc*B!%-$1-D?$Nu#9AJnx^en(|w7q^(~%y_T%
z?ZM<o<Q<2`x3xoA(T(p0e7;kW>Bj%uTkXBaz|bb|xv?Gt@p!cNl5-Qvz}R+x#I^p}
zC-p>9`yp@q+9nApZYr3MgJ|cQV{@K-zX-f0?3AUh$n_wP;);g5hIb|>1^^?c(L=s}
z-%}W43RuICp0r3LERfDlj~zr8#$)aopf3aqVY3LFr(g&=GQY*sp==R8+a@y@5mFZx
zKqFd?iHJhz_E_>saZg$Vi^m^X#*TBIX<)->p-OSNLg7}D&!oGpc*H{pnB+Wt*+L1k
z+s=hND7UTeDIr;B#MH>dGtE>Rc8WJV_7Y6~jMhXJ!4F;{SR}Zv;@KPCt5E<k)0>8@
zX9!eE;ks}!%-hhsaPWszfRC0$5TWxxD$&5rc(w!*Uu<hz(fcsk1Z8JqSNMfoP(l=3
z=x3iw+pMU7{F3rUDE0Nk@kdu^4V^_R*GoOavU~9;r7LiKXR(@dVUqzclRbXxF0K4d
zH{aB=R$P6R6bjRf!=S*_aY3Sc!E1dI{tzzTNe~0J>0&SJkSGD7s`Bav(Zy`G-Vvj^
zISEi{*`TTfuOQ+Nx+*EL7|PeL%MbfF-}*c<WUbOVe0DX~$7oRCeuy(MuwwW>8FXg8
z7?!v*V_Kq>iS&owQ@q!eA7q2{r+O%-3iJeVB0;07yfa7|^&9c8ru3oI8oy=?^*AAb
G-2VcuIlF)W

diff --git a/docs/figures/CylinderVolumeBounds_decomp.gif b/docs/figures/CylinderVolumeBounds_decomp.gif
deleted file mode 100755
index 762a477cc39411ca33c03e6c2b70ab88980876c7..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 7317
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

diff --git a/docs/figures/DoubleTrapezoidVolumeBounds_decom.gif b/docs/figures/DoubleTrapezoidVolumeBounds_decom.gif
deleted file mode 100755
index 0e8ddaac784cb1178e567fb0ce93ec19a3a157c7..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 40894
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%0D<212#NT$PguX-+aYWh^J+fp(MBr
zYITh}x&%N+$}7fbY1Oq-MIB6#V!FVgBws4I*IF=!5QlBgG<U?`Z5CQYzL~6g0X`;7
zN_DuPqV>RM%~x4XHlAV$_#)Fh+rkh?l!CSQoQorAkOd{8a$)eb)!R!jgO-70xdfmh
zbc{g7)W`Dvt*ERE&?rC&t^>7dGarc&shF$JxXI}XFf_@UuBr#RJo9Y%dRw%{Oc3v_
zsw#uKQsS8VHy!~+Sb`~yh#J-uB&()@m!gU1piHc=W~_P?38pfX0@wc1RfK=>8KYZR
zTx3Mr^wWK+<F0y9ls6R$JJeDS%LEpoVTGidlgdD^E;W);W-D#BQdOr<=3>#5t58Tb
znI^F_lDl~G#LS5nS>t5HWVbUA4#cAkRmmw$7Aj`dysmvJ3+-Yc=_=GCim-4Z5O$Wv
z)v$vkrGNs(k({e#6kbW4BRQ%>i~4p$o@u_H*0W_VgdEsWFzxyhTXuCtM4ZZR|B@=L
zu6Wrj6Z1{P%~ElGD*LZ^43tbl=O{u_x8FBqugGu55}@GQPC(I-k}TaE3WU}x7Ga27
z;#_0uP+%E3k2zK_l5(<;gB&`VBEf^>^R4jv<OG2^zf;tf8vZsNCJ}8@$$hu)s`qYg
zX-Z;#I)hNyNT;n~`A@IT<6|6`WIE~1O4P%G9~2q9I2gi>U{Dhuv8U_qYwt>wus+C8
z`yHoS!S_S<GxN4fhN2F!<8pG__Ua&BIQWUYRv@pHk3S}%>Owif!4mGkTitJ<ry9Lk
z&X&1*C@pOQ%+|Bw!=K&PmD^O)zKlcoOA=?8NWUv?ZP|Jj#V0U`FZ$>;Nb=&RE5K4G
z59&Rn89IT5gurGa@tbcIs;dYhw<U|7c5nKdQGPf*#!%$T6n^BRU(|s?d-}gJr^2*<
z^yiO1{RP>0%owoq^-t1POEUib_Z#*B-~bAlIn7_m{?QvkEzkiHVDA`S147_U^~cZA
z-{(1%hOk})wwITniw1gN@B9tL1Xa%E764w3j;Ibak%V`A;Cg*i3nIr#$>0pqU=7;f
z4dzOV_!G8#7y;r%FX+f!Yzz!O*6U>)5q<@Cv>FaFVG}wb6Y5{?fX{DCpLJzN+<gXG
zL`Ym<Uh4Tq>RE*IyhO@rp<o1vmib6e^-<rn1qD)Aj2*^@G+s#jhUH;JZtz41p@u~~
zg&l%L0$Rz2gqu>ppT_A3Au3h^<&Q=I9uj&*1{}&0J>eu$A|=Mu5e`RS_0~ph1r&)7
znI$4FEnAEjm}LCanP^oSzQjR<kW0Xw5anV1E4^3j`5rhSR1hIVD=q_{G!gl6MFw`?
zlpG$2XyM1vlPDeqWhe#Flu0qRl1-!z+tdWB*~gl|#uxREBa#KB_~M=Po;QMHH;Uso
zj$=4BL|-77ia^KSSW7n6gifH!YZ%c|C?Z-x1?Kf#0+rzM6+~Ng#9k<2PlQ`r)lo#~
z!4O3THdY=uf(Sztg_c-F)Zt10L6;y31d?dsWh`5QC>Z_)mh(UbeLRJugxZ003{QMs
zBWfd8yr9VK4WdwBa0G^SIMUDMOO&)lXPHn=VW3I$O}>0YlnmLX=*CJVLSV2H22Bi3
zywe&Igd@FySk;94oD57j<3-d42(<pyo5_n;IFhMQMxlU!0Pb2u775Cb$wCxEttrEH
zwNefi<(EJS&QuOHI?PCPLvLZ?N@_)zRULj1jRGY{7uuEK@ZPRfCBh(#ZS2<?@|v|}
z$gnMu<uFPP`WX0BN0>DdeC5i%1&rr>6i<>9R%uAC_)r*S6jt1eLQRQYGK_wWO=Thx
zL(IygsF=nnina({|L{mV;fzcqN{5x^#35i0vQbZvWfI~Q8XabkfeN}Lr{tAZb2`k&
znT)n9SICUZoN0!rC=x5ZUQ!SW<J?c|m`p+l-Nxk;_+%J2;un&z(o6hD%goZpIApy5
zh$Nwkhxs2!wNb~Bm@ybkLjJW|HUg!3K+&co)tU%bL;M$fVWoOX*?K0<crZ@~_S?+i
z7V6Z+_JKusOk7}<T=TpLQal+gT7^2nR6|rxGoggph{hBZi+5(srW8+svCiNO!~q-%
zl4(bxv_+xhPbW1+G0ct}c~fJ_*1=e%_`s+ZV#I)E$P?L_n|PYR+}+5O6uA_UPF{}a
z`54305Mbd&?5rDW=)vn~p)z1+!{OJe*cfXB6-}sQdpRVrAdg733InplfzaqnF`x$3
z4TNHtIzpH#8ik5}rcPxBbPUzo(9KRxi5jiY*eI#jh)GkK$iS7v>nu={bOR;XN1`l_
zf?CJknFe(vji|~6{wf&-7c~%)=><yE#&meltA&xnU4eS=XTuo|g+1vLv8R~$Qd!B^
z**pYMqM=jRk+H(bP&8G2?qz$eoNAVid6h+GgigIMlHU=h(``s$Rjak?h<X-;5s=Kp
z@kns>W>6gwrZFN2bWM9~*S|F=moicI+?P!C+@CQ@%GgH+pbPy>lz>SkJPBq+<iyx0
zoT`mx2-4EQjtqa@i}bk@HN^@JRm>X*8e*MPRmSDC23ZDBT`<9>aNrpdd1(}inm5U-
zW+ex7#OF*^r~RBwU6>dXvCMQ>&_V!BwmHzNP}g)xW2BAB)wSy3=nF(p0I3#4H}py(
z3=pD{2&EkUK!jexxRQ@T$!4}Rk$^P~9X=R8Xq!aID&H)|1^pF)9!{$5ifEt(PgUcO
z-H*7eRI70!)?rN8cn)od=tBjE+F**u1zxKtTyjv9K*VIKl<Rh8ir08d<z(Xpy;B!_
z5k9SEMI2;0&LW{U36H#qQ+AhS+ALJr3g$kXzh=#rS|NiqAExjsuXI)9bZ*x$iEZe?
z9(j%SH3oL9MdA66gQnwhR2%AwtT^S*6(Cuw&X-jJj#+S^XdKY-xn$yKOQ80p_#6xG
z<i|4=0}0y1XBNZ*NQ`6fL(-<yrR8hjSZb*DOH~w|=d3T>P}np1mQDB)RU(!oD$|DG
zo=yJ2kC`Sd!vPSOm?4Y?S8%=KS#FNfJ&^R~E#sP1!w?3cIt;;r#CRB-r7BWUZep*k
zU{7@&%ls~nMCUn`M$L7KRon&i#+Gd`4fbkKe>jo_4hO~h#IlUjy;cWO7}^A<RPbJ>
z8!c)<i~|3V1_%%lsyK!t{Y`lRfHBA@1K~$}hD5p8j7pg*9XgwQFph9a%k(%Ymzc^#
zSk7v&Cv9BK6%(;qxYnMb8IuATiou1N7DPdbvG^$7Ytbu(K@z+4LRlTlP;7^2B*JmF
zmt&!hvz2U6EN)hyuYY14ZBp-W@PoKOlc;=z4fDjHf+_!a$F#sLZu(5Eh|O-5ul^g^
zQ1lMhy^<JW1W-@d(P0Fqt(fY}a1r+H?XHPPHy|2wNU5R_2_Ws~rkn=&RPdLyhENp7
zN!?jqz=rvr+XGPyQ5KLiaSCkeCtP5_rQ{suD3@V441ff)EiP8xJV5M1ZcRvTS;UDP
z*%6WT+xb|V4Ob00trYKN=E^LJsGbT-kxtA!)Z1FB|9*tfP8$Hx3jiQArr8_mnAW1m
zs}Rl*q|l4JiiXg-7-7Db{9YG{MT!!q7q*!07<xoQiv~b;L9%5F>m4Mm=nAC_G`%d5
zro`??^g<>*P&L(Ni(Ucx8WI2;@vwXtvdr4283Xy85kyi<^*r)b7=e)f{$}x=sEQih
zG9>jQeM(J8&B*Ab)rjsx=it4-w2xF9%J73a6LjfJ^9r*Lg2CCR3=ko&^<gG0z{stt
ztt*=Snra+{Cr*rd#B-9S1+~1+#^eP+R}Zgk8{VW4yBUgz0`_?ANy<1zWU;AlKI1tf
zSAI0iZ?GV|N*pa&wYPd&k;RkFqz_-R_6Ir_`)ZRH^~l4K#X;yUX&$er#gE@1)_Brc
zYXi3iZerJ+l#Ski&;E3C_S}Y48-`S}-ZJwfvxR7UOK@BF0Q#^}v5x$zhn7f8Ss>(8
zqo1H*oeb^Db)$Fth0SB5%;L;aw&YrFpI(uGfY2W2b5~t$IBUNCr6TdA_kRaoW`v<p
zgy6Y~h1kAR1fyS_KGr}O10n)=giHAHQB=q^U>7U*glqVQ+v)y5ig6L3AKzC#a(IcG
zcsMCiVVyAYy|g@^_>05%Ah8T=Jau_XVw{j{jO+N0haQ8gH^Lk&j|=&br;ELMAW$+X
zkt_L<uLyq7v<Jr5elhu!Q~7cDc={!V!PIz_b9t9zoQLjTjF1kPdwH3gIT&Sl{6U0~
zpLv_R`L{Np`N6rH(|MIk_5Wy|362(F)_I@ncw$0dYX2VS{gL(g`Jumf2EbUN=?=?|
zUOeYVk0JV`m-riMhy`-c#O~vQ7c8ZF`i8Tnh<2VK$?*Pq`I1g;`KPOT3!2PD?QjgI
z`ClF?2CaIn2e*Z1uY8M~8I`uJ`}#^&_=tQTeuEz8l?sUeda^rW20S@S_PYG(7k6*A
zvQs+*l8%YY$<@&xR8UH)SNpenD=0<hl~*0=7$LZ$d;R4Iv9k-iBOke^d%S<ziV>Pu
zxcj@Gw!G_mh8oTdEv~j-_`UD@z~2-xxsko+d-@s7%MyIU=UY5i&x!+lz$1~vTl`~H
zWdA(1z!x8|>H5Wk{M5jxw!GPY?=x+Oe9D86ZjJJwvvy@+s-&y@%-_zx`FCp%*~ioT
z&cBF6J34DCg(vne&lA17$jd24c)(mrFC0kGJN|u%N>sgrdcr<^)%OX<uO!XE7~WZZ
z*AvHQtmU(#_jl^N*PA`tWtx;vxI#$95T5<pL$B)2(~0B7NUS*A<9%ezr`Z3urTu)~
z1HOEu1=gp@rbD2&2R_`FNrJndGclwFCVb*cKCzGvQ*TA1yZrva`{a9lV(?Z)-}7Y3
zd<5DM=bL^LokVI9Qm2~h;pf=tpT5DRu~+10MY(o6!+!3!q|Als2c~I!=6>#rN{2Mv
z#A{%-1%LA6tymB~zDIuY=e@@}1(~-y-)laKLciqW7=}}AiatO6ZGQHfJ;r39R@6QW
zL!fYqfAYgc&g@=5wf?rNVZ)I4`on$a{wkN{JKsNNO{uGwI0M8L00X-$Gk6eTLWK(%
zHgxz9Vnm4(DOR+25o1P;8##9L_z`5tidU8?8wh}+9+Cz#99$_9W=w_{-kdb3M`li)
zJ9+l>`4ebRp)heS%U}}a%ZDqAE-N?`Dnybb0rVPZ@M%=7Te)`i`W0;0Whad+Q@Zf%
zm8oL8UIB5HZCtr?>DIODlixvp0E#KQYj@>IlurK^HhdUy;<kFn!c{DGug%AkDOa|9
z*&)dcSGruWIv8`*vSW*Z4t*MRYSms}W)Qqus6YT93|<)x8+UHqyDf5l2>>bYoO-&H
z9+=l4a^cIFH`mP<E=lFiHx8`+NgaE3?UlO?EVc~i^z9a_njU{1efq_cmwjof9-?*g
z@afmL5A!w2toIe_Ir*Kx00kUSqAvI<jj;U)lx;o&9ei-W*J^{XF#r^#5W@_&qslu9
zpE~I*4MiNWIR=+0>plK(a_u@2U3@V&<s=KyzJdxG1vs@}+>yu2S~9D`2?fN7f|D-k
z5y>PK<IJFwlu5BZCJjQWK_#ucQZ4{$suI4eiqjHEEX5o%tS(HVZNP4>;D^DoE+iAq
zIDNXpxMKudiNgtLl#|asMPl#1q71xhPd^PkG$TDCQ|3+j$|?rIFcF=U(u*VvFfzvq
zt(4PF%@S;_O|=`8FSGvgg3{AeDa{K+N$VpuAyHMG70wUA{87C0NR^e=Ug7+WP*>B#
z={RA1J=Rd~*0OIPMr%VA*=VoS@ls|ZMW|6}wS`eiBa|^NSBe0w?24v9-4@+nE96qD
zAbGt@I;WsxH{E()B<YJFG2)P3#9AWNLVE>P5~uD=0`DSzjZN$&fCqk9Nu=IYNMX!w
zlMGsjHO7!i{SL|&A%!Qd3s{su-WcTt|9ke`iY+S$C;tW-Ipvz+>uy|$L=Nq!Rx`F4
z=qN$#tR-Guw(N?Q1UotCrgcS1xp2{P_cFDdq}l1LOKcK2HkaXtX&`f+te~ai)f#Q|
z0)s2;+Dyb+F8<<tPMdDE*FCYKv6svj(4Xu6TQ}E~9cf0)PWrKJz!gW0q_+S#8zQhN
zSY~p5{4NZ-q|JhR@y->?s~h9Kj)-%3^+mXJ&sDz*xl9Se&dJqf&#f$lySS~nYG>a)
zwMCUlo!puZ=AC%eApI7*LH#P8dCGJ|PIu<C?6>*q>C*3L=0vxi`^U<5EOBzVPOAIz
z5fco>-KZU?7xUdOOt!ZYjPW2yuL}SD{DUe=u*om4jDI%ypZ*9a6tI0}c}@Y|UtWX1
z0zQx@48jv^N=7{hUT`O6;Tu6BqPN17<s=2c9R^AGla}P=4UhsILw5EUoB?1o3oPLb
zC!!Xr{uHAo-9Q+{PKOxefM82Hq~Q>EvJzI=q){zY%(-?*L?_0?YBSqY_7Gzn3qBEx
z)d|+rY$C&<5X*yE6eCA^kwTbp(J_hH%Nyi3MmL7UgGxN#wcc1qj+CYsQ|zG+jpIc-
zj!_`rs*)TF1FJtCQX|n5TN=;DNJKtTB3G-O4aesa(>2K?-w`4tIoXgOog`li38P$m
zBN(Z55|v*Q9B5SHlET@gGiD)`vr<`0OWqAD$?3x6DmOr|6bV6Iv!yL@l1bC}Q7g8(
z;xO%a!<n6Cl+1+W7d`_ZWQyi%!I7pdr*eg3ROJmAunclOgOW{dlasNe;$v84mF4;V
z5}kk~4S<kV&3JN?Fs8K3Yv6fLH!2b_50DRGPU+7-nuuJW)RRF`$sh+p#*hrP<@c7E
zCEyIEb`ou9H0>goA8E9f9HmR9=n2wPF3l|4n@hP4GMi_bG?jV5A*3pKO_99BTP}rZ
zDwT<nRoZ1Uoe}9y-N>&ak}obVLE%99NmMKva;Q+z1365El#e>~k$DlSO+K?QumlD{
z55?*byYK}o3KDZyDd<@1D3~s;^lKLdKvUUT!dS+&G*r4ClO$x*y1GwkZuRO{PqNm(
ziV-IObEH_N!XB|6mV`JnNg_rV7X#7roRB?av+jpCvFI>U{u``jv-rZRJfQwA>@&(}
zNt;F4(DSiH>_Q4T=-1YEFR&&PCn*7XTl3LXAu6@#VtwmA8?|yIpMnc;dveiU7`C|9
zyMi$=(giauLx*=|OK>V1-SR>2B1Q2{YU$|R_p$GB7(uR(*dn^vnpbhX&CEg88yCSa
z7rq*M4?nKT!p3mKtpOJBfC*e+1HTld`Td(_4$@VW@WTke;URIwbzlo$7{ky(T?UHL
zUj?J>uHUN-N^+JbEoK<SDHbe3isIo92kj+#_(G{#s@GWk_cR4z%2S~G;*AN@abN>a
zL_>z-(5xgYKeDZlQw1#TR%kP^y29`<@>V7@lQWUZfY&&96CHDHU;b3PvMr%!o^D)c
zMHAXgd26`GF{4tM2+{CZ`a7slCfCYu<|&7|z~xfyWpq2F@KW5YXHJ?607uMJdc`Z>
zh7i)wsoWB19O+hNc+GO8D|Dngi5!xE_R(v}iqXW(X;iw2y@7r-(b^nUQ`d1N-FWY#
zOZ{p{##p=1EmzAnZR>+J(QUHwlBV<Q>*DI@bW1iiGhMxGqTa?N&vmwWB}cihDSO)Z
z{BpLr-ED7w8{FX*_qfSjZgZa--RV~My4l@scfT9n$r^OLhY4wVW4YJ&#%Hnhjqhgn
zyP35Hcq)<29&8WXeK=vT4iAoS<65%e4tJlFmi0P`bF$)YC%ZVoZ@h7je;ni?7x~CZ
dUUHM49OWrj`N~<|a+kjx<}sJ~%y|?L06R0p?!5p2

diff --git a/docs/figures/SubtractedPlaneBounds.gif b/docs/figures/SubtractedPlaneBounds.gif
deleted file mode 100644
index 24adf0eafc4e1fa0f2dfd7893fa865050470f16c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 22485
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

diff --git a/docs/figures/TrapezoidVolumeBounds_decom.gif b/docs/figures/TrapezoidVolumeBounds_decom.gif
deleted file mode 100755
index 5066a7d685087a8d9ac595f324b73e07dbe45d46..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 7468
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
S+#T?%Dto7{ZHEGY^Zy6A`_E(m

diff --git a/docs/figures/VolumeShapes.gif b/docs/figures/VolumeShapes.gif
deleted file mode 100755
index 0b56d1a41d4db624184c098910afd993900b71f6..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 9070
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
L?+X_R05tv&mRUqP

diff --git a/docs/figures/ConeBounds.gif b/docs/figures/doxygen/ConeBounds.gif
similarity index 100%
rename from docs/figures/ConeBounds.gif
rename to docs/figures/doxygen/ConeBounds.gif
diff --git a/docs/figures/CylinderBounds.gif b/docs/figures/doxygen/CylinderBounds.gif
similarity index 100%
rename from docs/figures/CylinderBounds.gif
rename to docs/figures/doxygen/CylinderBounds.gif
diff --git a/docs/figures/CylinderSurface.png b/docs/figures/doxygen/CylinderSurface.png
similarity index 100%
rename from docs/figures/CylinderSurface.png
rename to docs/figures/doxygen/CylinderSurface.png
diff --git a/docs/figures/DiamondBounds.svg b/docs/figures/doxygen/DiamondBounds.svg
similarity index 100%
rename from docs/figures/DiamondBounds.svg
rename to docs/figures/doxygen/DiamondBounds.svg
diff --git a/docs/figures/DiscBounds.gif b/docs/figures/doxygen/DiscBounds.gif
similarity index 100%
rename from docs/figures/DiscBounds.gif
rename to docs/figures/doxygen/DiscBounds.gif
diff --git a/docs/figures/DiscSurface.png b/docs/figures/doxygen/DiscSurface.png
similarity index 100%
rename from docs/figures/DiscSurface.png
rename to docs/figures/doxygen/DiscSurface.png
diff --git a/docs/figures/EllipseBounds.png b/docs/figures/doxygen/EllipseBounds.png
similarity index 100%
rename from docs/figures/EllipseBounds.png
rename to docs/figures/doxygen/EllipseBounds.png
diff --git a/docs/figures/LineSurface.png b/docs/figures/doxygen/LineSurface.png
similarity index 100%
rename from docs/figures/LineSurface.png
rename to docs/figures/doxygen/LineSurface.png
diff --git a/docs/figures/PlaneSurface.png b/docs/figures/doxygen/PlaneSurface.png
similarity index 100%
rename from docs/figures/PlaneSurface.png
rename to docs/figures/doxygen/PlaneSurface.png
diff --git a/docs/figures/RectangularBounds.gif b/docs/figures/doxygen/RectangleBounds.gif
similarity index 100%
rename from docs/figures/RectangularBounds.gif
rename to docs/figures/doxygen/RectangleBounds.gif
diff --git a/docs/figures/RotatedTrapezoidBounds.gif b/docs/figures/doxygen/RotatedTrapezoidBounds.gif
similarity index 100%
rename from docs/figures/RotatedTrapezoidBounds.gif
rename to docs/figures/doxygen/RotatedTrapezoidBounds.gif
diff --git a/docs/figures/SignOfDriftCircleD0.gif b/docs/figures/doxygen/SignOfDriftCircleD0.gif
similarity index 100%
rename from docs/figures/SignOfDriftCircleD0.gif
rename to docs/figures/doxygen/SignOfDriftCircleD0.gif
diff --git a/docs/figures/TrapezoidBounds.gif b/docs/figures/doxygen/TrapezoidBounds.gif
similarity index 100%
rename from docs/figures/TrapezoidBounds.gif
rename to docs/figures/doxygen/TrapezoidBounds.gif
diff --git a/docs/getting_started.md b/docs/getting_started.md
index b5a9cc9738d..0c6431ce9d2 100644
--- a/docs/getting_started.md
+++ b/docs/getting_started.md
@@ -52,7 +52,7 @@ These are usually not available through the system package manager and can be fo
 
 All external dependencies must be provided prior to building Acts. Compatible
 versions of all dependencies are provided e.g. by the [LCG
-releases](https://lcginfo.cern.ch/) starting from [LCG 97apython3](https://lcginfo.cern.ch/release/97apython3/).
+releases](https://lcginfo.cern.ch/) starting from [LCG 102b](https://lcginfo.cern.ch/release/102b/).
 For convenience, it is possible to build the required boost and eigen3 dependencies using the ACTS build system; see [Build options](#build-options).
 Other options are also
 available and are discussed in the [Building Acts](#building-acts) section.
@@ -125,13 +125,16 @@ A set of container images is available through the [Acts container
 registry][acts_containers]. The following containers are used as part of the
 continuous integration setup and come with all dependencies pre-installed.
 
--   `centos7-lcg97apython3-gcc9`: based on CentOS 7 with HEP-specific software from
-    LCG 97apython3 using the GCC 9 compiler
--   `centos7-lcg98python3-gcc10`: based on CentOS 7 with HEP-specific software from LCG
-    98python3 using the GCC 10 compiler
--   `ubuntu2004`: based on Ubuntu 20.04 with manual installation of HEP-specific
+-   `centos7-lcg101-gcc11`: based on CentOS 7 with HEP-specific software from
+    LCG 101 using the GCC 11 compiler
+-   `ubuntu2204`: based on Ubuntu 22.04 with manual installation of HEP-specific
     software
 
+:::{attention}
+We stopped producing fully-contained LCG containers in favor of running LCG
+based tests directly from CVMFS.
+:::
+
 To use these locally, you first need to pull the relevant images from the
 registry. Stable versions are tagged as `vX` where `X` is the version number.
 The latest, potentially unstable, version is tagged as `latest`. To list all
@@ -217,21 +220,17 @@ To activate the documentation build targets, the `ACTS_BUILD_DOCS` option has to
 $ cmake -B <build> -S <source> -DACTS_BUILD_DOCS=on
 ```
 
-Then the documentation can be build with either of the following two build
-targets
+Then the documentation can be build with this target
 
 ```console
-$ cmake --build <build> --target docs # default fast option
-# or
-$ cmake --build <build> --target docs-with-api # full documentation
+$ cmake --build <build> --target docs
 ```
 
 The default option includes the Doxygen, Sphinx, and the Breathe extension,
 i.e. the source code information can be used in the manually written
-documentation but the full API documentation is not generated. The second
-target builds the full documentation to automatically generate full API
-listings. This is equivalent to the public [Read the Docs][rtd_acts]
-documentation, but the build takes a while to finish.
+documentation. An attempt is made to pull in symbols that are cross-referenced from
+other parts of the documentation. This is not guaranteed to work: in case 
+of errors you will need to manually pull in symbols to be documented.
 
 [doxygen]: https://doxygen.nl/
 [sphinx]: https://www.sphinx-doc.org
@@ -239,12 +238,6 @@ documentation, but the build takes a while to finish.
 [exhale]: https://exhale.readthedocs.io
 [rtd_acts]: https://acts.readthedocs.io
 
-A special phony target exists to clean the documentation output files:
-
-```console
-$ cmake --build <build> --target clean-docs
-```
-
 ## Build options
 
 CMake options can be set by adding `-D<OPTION>=<VALUE>` to the configuration
diff --git a/docs/howto/howto.md b/docs/howto/howto.md
deleted file mode 100644
index 75b9dc5791c..00000000000
--- a/docs/howto/howto.md
+++ /dev/null
@@ -1,12 +0,0 @@
-# How-to guides
-
-:::{toctree}
-:maxdepth: 1
-
-material_mapping_and_validation
-run_material_mapping
-run_material_mapping_auto_tuning
-produce_digitizer_config
-run_ckf_auto_tuning
-add_new_algorithm
-:::
diff --git a/docs/howto/material_mapping_and_validation.md b/docs/howto/material_mapping_and_validation.md
deleted file mode 100644
index e7487e9aad9..00000000000
--- a/docs/howto/material_mapping_and_validation.md
+++ /dev/null
@@ -1,2 +0,0 @@
-(material_howto_core)=
-# Howto run the material mapping and validation
\ No newline at end of file
diff --git a/docs/howto/produce_digitizer_config.md b/docs/howto/produce_digitizer_config.md
deleted file mode 100644
index 7fd4957335c..00000000000
--- a/docs/howto/produce_digitizer_config.md
+++ /dev/null
@@ -1 +0,0 @@
-# Howto produce digitizer config
diff --git a/docs/howto/run_material_mapping_auto_tuning.rst b/docs/howto/run_material_mapping_auto_tuning.rst
deleted file mode 100644
index 8c4dceee5b4..00000000000
--- a/docs/howto/run_material_mapping_auto_tuning.rst
+++ /dev/null
@@ -1,90 +0,0 @@
-ACTS Material Mapping Auto-Tuning Tutorial
-===========================================
-
-(This how to uses **deprecated** executables and will be updated soon)
-
-The material mapping can be quite a cumbersome process, especially when used on a detector with an evolving geometry. The point of the auto-tuning is to replace the person power needed to perform the optimisation by computing power and time.  This tutorial will present how to perform the auto-tuning of the material mapping process. It assumes the reader is familiar with the concepts related to the material mapping. For more information, refer yourself to the `run_material_mapping` how to guide. This page will explain how to perform the auto-tuning material mapping with the Open Data Detector (ODD) but it can be applied to any other detector (see the other how to change detector).
-
-Prerequisites
---------------
-The prerequisites are the same as for the material mapping, we will need the ACTS Examples, Geant4 and the JSON plugin (``ACTS_BUILD_EXAMPLES``, ``ACTS_BUILD_EXAMPLES_GEANT4`` and ``ACTS_BUILD_PLUGIN_JSON``). Depending on the type of detector we want to map, you will need to use some additional packages, in our case ``ACTS_BUILD_EXAMPLES_DD4HEP`` and ``ACTS_BUILD_PLUGIN_TGEO`` are needed. The auto-tuning is implemented as part of the Acts python bindings, we will thus also need to have them installed (``ACTS_BUILD_EXAMPLES_PYTHON_BINDINGS``).
-
-We will also need an optimisation library. The material mapping auto-tuning has been implemented using Orion (https://orion.readthedocs.io/en/stable/), it can be easily installed using the following pip command:
-
-.. code-block:: console
-
-   $ pip install orion
-
-Configuration
---------------
-
-Similarly to the regular material mapping, we first need to configure which surfaces will be optimised in the mapping. For this we first need to extract the list of all the surfaces in our detector, to do so we will use the GeometryExample:
-
-.. code-block:: console
-
-   $ <build>/bin/ActsExampleGeometryDD4hep -n1 -j1 \
-       --mat-output-file geometry-map \
-       --dd4hep-input <source>/thirdparty/OpenDataDetector/xml/OpenDataDetector.xml \
-       --output-json \
-       --mat-output-allmaterial true \
-       --mat-output-sensitives false
-
-The JSON file can then be edited to select which surfaces we want to have material mapped on. To add one surface to the material mapping, one simply needs to switch the ``mapMaterial`` variable to ``true``. The binning doesn't need to be changed, as it will be decided by the auto-tuning algorithm itself.
-
-As a rule of thumb, the material can be mapped on the approach surface of your sensitive surface and the boundary between the different volume of your detector.
-
-.. warning::
-  When performing the auto-tuning, the list of surface the material is mapped onto must stay consistent. You want to change the surface used, you will need to restart the tuning from the start. 
-
-Geantino scan
---------------
-
-The next step is to do a geantino scan of our detector. For this, we will use the ``MaterialRecording`` application:
-
-.. code-block:: console
-
-   $ <build>/bin/ActsExampleMaterialRecordingDD4hep -n1000 -j1 \
-       --dd4hep-input <source>/thirdparty/OpenDataDetector/xml/OpenDataDetector.xml \
-       --output-root
-
-
-The result of the geantino scan will be a root file containing material tracks. Those contain the direction and production vertex of the geantino, the total material accumulated and all the interaction points in the detector.
-
-Material Mapping Optimisation 
-------------------------------
-
-Once we have our json configuration file and our geantino material track file we can start the optimisation of the material map. For this, we will use the ``material_mapping_optimisation.py`` python binding file. This script file has five options that can be changed:
-
-- ``numberOfJobs`` the number of simultaneous jobs executed (this can be as high as you want, but if you have enough Core 40 works quite well).
-- ``topNumberOfEvents`` the number of events from the input material track file used in the mapping can be changed (by default: 10000) it needs to be the same in all the calls to ``material_mapping_optimisation``.
-- ``inputPath`` the path to the input directory
-- ``outputPath`` the path to the output directory
-- ``doPloting`` if added at the end of the optimisation script, the optimal material will be computed and result plots will be created. (Should be used at the end of the optimisation).
-- ``readCachedSurfaceInformation`` if added the material-surface association will be taken from the input material track file (doesn't work with geantino file, you need to use the material track file obtained from running the material mapping).
-
-When using Orion our optimisation algorithm can easily be parallelised. Orion uses a Database system that stores all the mapping configuration tested so far, before starting a new trial the database is checked that the parameters have not been used before. Each time you run ``material_mapping_optimisation.py`` a batch of ``numberOfJobs`` trials will be performed and added to the database. Once you have run it enough time, you can extract the result by running with the ``--doPloting`` option.
-
-The current python script uses a simple random search, more performant algorithms could be tried. You can refer to the Orion documentation to see how to implement/uses them.
-
-To simplify the use of the auto-tuning a bash script is available in ``Examples/Scripts/Python/Auto-tuning/Orion/``, performing the optimisation should be as simple as launching this script. You will only need to modify the path to your input and output directory that are called ``MaterialMappingInputDir`` and ``MaterialMappingOutputDir`` by default.
-
-Material Validation
---------------------
-
-Once you have run the optimisation enough time and extracted the optimised material map, you can run material map validation from the ``run_material_mapping`` to validate your map. 
-
-
-Implementation 
----------------
-
-This section will present in more detail how the optimisation is implemented in ``material_mapping_optimisation.py``. This information is not necessarily needed to run it, but might be useful if you want to modify the script.
-
-When calling ``material_mapping_optimisation.py``, we create one process per surface using python ``multiprocessing``. Each of those trial processes will be in charge of optimising the binning for the corresponding surface and connect to the corresponding database. This is needed because Orion can only have one active database per process. In each of those processes we will create ``numberOfJobs`` trials, each trial corresponding to a different binning, then pipe those binning to the main process.
-
-After creating the trials process wait until it has received one binning per trial process (so one per surface), those are combined to configure one material mapping job that will be launched in a separate process. This is performed a number of times equal to the value of ``numberOfJobs``.
-
-Each of the mapping process will need to perform the material mapping twice, once to determine the average material in each bin and a second time to compute the variance. For each surface, a score is then computed using the variance and the number of hits in each bin. This score is then piped to the main process.
-
-After receiving the scores, the main process pipes them back to the trial processes which will store them in the database. The script then ends when this has been done for all the jobs. If the ``--doPloting`` option was used, each trial process will also return some plot related to the optimisation performance so far. They will also pipe their best binning to the main process. One last mapping job is then performed in the main process, this will return the optimised material map and a material track file where the material is already associated to the surfaces. This last file can be used for validation and as an input to futur mapping jobs to speed them by up to 50% (using the ``--readCachedSurfaceInformation`` option).
-
-![Diagramme of the material mapping auto-tuning](/figures/materialMapping/ActsMaterialMappingAutoTuning.png)
\ No newline at end of file
diff --git a/docs/index.rst b/docs/index.rst
index 134982116ca..9df04ab6fd9 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -21,24 +21,29 @@ Key features:
 * Implementations of common vertexing algorithms.
 
 .. toctree::
-   :maxdepth: 3
+   :maxdepth: 1
 
    getting_started
    tracking
    acts_project
    core/core
-   fatras/fatras
+   Fast Track Simulation (Fatras) <fatras/fatras>
    plugins/plugins
    examples/examples
-   howto/howto
-   contribution/contribution
+
+   Contribution guide <contribution/contribution>
+
+   api/api
 
    versioning
    formats/formats
-   api/api
    codeguide
    authors
    license
 
    white_papers/index.rst
 
+TODOs
+=====
+
+.. todolist::
diff --git a/docs/known-warnings.txt b/docs/known-warnings.txt
index 0c946f4fc40..3605eadcc56 100644
--- a/docs/known-warnings.txt
+++ b/docs/known-warnings.txt
@@ -1,12 +1,8 @@
 # Each line should contain the regular expression of a known Sphinx warning
 # that should be filtered out
 .*Duplicate C\+\+ declaration.*
-.*Duplicate ID: .*class_acts_1_1_frustum_.*
-.*Duplicate ID: .*struct_acts_1_1_surface_array_.*
-.*Duplicate ID: .*class_acts_1_1_axis_aligned_bounding_box_.*
-.*Duplicate ID: .*class_acts_1_1_magnetic_field_provider_.*
-.*Duplicate explicit target name: .*class_acts_1_1_frustum_.*
-.*Duplicate explicit target name: .*struct_acts_1_1_surface_array_.*
-.*Duplicate explicit target name: .*class_acts_1_1_magnetic_field_provider_.*
+.*Duplicate ID: .*
+.*Duplicate explicit target name: .*
 .*doxygenfile: Found multiple matches for file \"SeedFinder.hpp.*
 .*Duplicate explicit target name: .*class_acts_1_1_axis_aligned_bounding_box_.*
+.*undefined label: .*class_acts_1_1_convex_polygon_bounds_3_01_polygon_dynamic_01_4.*
diff --git a/docs/plugins/autodiff.md b/docs/plugins/autodiff.md
index e4eea4f9c53..6b0c2c02128 100644
--- a/docs/plugins/autodiff.md
+++ b/docs/plugins/autodiff.md
@@ -1 +1,5 @@
 # Autodiff
+
+:::{todo}
+Remove autodiff documentation?
+:::
diff --git a/docs/plugins/dd4hep.md b/docs/plugins/dd4hep.md
index 771461632ab..0dd9a656a7a 100644
--- a/docs/plugins/dd4hep.md
+++ b/docs/plugins/dd4hep.md
@@ -1,5 +1,9 @@
 # DD4hep plugin
 
+:::{todo}
+Describe new markup and construction for dd4hep plugin and building layerless geometry.
+:::
+
 The DD4hepPlugin allows building of a {class}`Acts::TrackingGeometry` from
 [DD4hep](https://dd4hep.web.cern.ch/dd4hep/) input. DD4hep uses [ROOT](https://root.cern.ch) TGeo as the underlying geometry model.
 
@@ -187,7 +191,7 @@ The volumes are automatically built around the layers. Volume boundaries for
 the volumes are calculated automatically by adding a tolerance to the geometric
 extension of the contained layers. The tolerance parameters `layerEnvelopeR`
 and `layerEnvelopeZ` need to be set in the
-:func:`Acts::convertDD4hepDetector()` function.
+{func}`Acts::convertDD4hepDetector` function.
 
 Furthermore parameters can be handed over for material mapping or the axes
 orientation of modules.
@@ -195,7 +199,7 @@ orientation of modules.
 Summing up the `DetElement` tree in DD4hep should have the following
 structure:
 
-![Detector element structure](/figures/DD4hepPlugin_DetElementStructure.jpg)
+![Detector element structure](figures/DD4hepPlugin_DetElementStructure.jpg)
 
 It is also possible to translate a very simple detector geometry, which just
 consists of cylindrical (for a barrel) or disc (for endcaps) layers which either
@@ -259,7 +263,7 @@ ACTS geometry translation uses parameters attached to DD4hep detector elements v
 ## Usage
 
 To receive the {class}`Acts::TrackingGeometry` the global function
-{func}`Acts::convertDD4hepDetector()` should be used, where the DD4hep world
+{func}`Acts::convertDD4hepDetector` should be used, where the DD4hep world
 `DetElement` needs to be handed over. For a valid translation, that all
 prerequisites described above are met and that the right `VariantParameters`
 are added during the DD4hep construction.
diff --git a/docs/figures/DD4hepPlugin_DetElementStructure.jpg b/docs/plugins/figures/DD4hepPlugin_DetElementStructure.jpg
similarity index 100%
rename from docs/figures/DD4hepPlugin_DetElementStructure.jpg
rename to docs/plugins/figures/DD4hepPlugin_DetElementStructure.jpg
diff --git a/docs/figures/plugins/sycl/count_duplets.png b/docs/plugins/figures/sycl/count_duplets.png
similarity index 100%
rename from docs/figures/plugins/sycl/count_duplets.png
rename to docs/plugins/figures/sycl/count_duplets.png
diff --git a/docs/figures/plugins/sycl/duplet_search_matrix.png b/docs/plugins/figures/sycl/duplet_search_matrix.png
similarity index 100%
rename from docs/figures/plugins/sycl/duplet_search_matrix.png
rename to docs/plugins/figures/sycl/duplet_search_matrix.png
diff --git a/docs/figures/plugins/sycl/flat_matrix.png b/docs/plugins/figures/sycl/flat_matrix.png
similarity index 100%
rename from docs/figures/plugins/sycl/flat_matrix.png
rename to docs/plugins/figures/sycl/flat_matrix.png
diff --git a/docs/figures/plugins/sycl/middle_duplet_indices.png b/docs/plugins/figures/sycl/middle_duplet_indices.png
similarity index 100%
rename from docs/figures/plugins/sycl/middle_duplet_indices.png
rename to docs/plugins/figures/sycl/middle_duplet_indices.png
diff --git a/docs/figures/plugins/sycl/prefix_sum_array.png b/docs/plugins/figures/sycl/prefix_sum_array.png
similarity index 100%
rename from docs/figures/plugins/sycl/prefix_sum_array.png
rename to docs/plugins/figures/sycl/prefix_sum_array.png
diff --git a/docs/figures/plugins/tgeo/TGeoArb8_PlaneSurface.png b/docs/plugins/figures/tgeo/TGeoArb8_PlaneSurface.png
similarity index 100%
rename from docs/figures/plugins/tgeo/TGeoArb8_PlaneSurface.png
rename to docs/plugins/figures/tgeo/TGeoArb8_PlaneSurface.png
diff --git a/docs/figures/plugins/tgeo/TGeoBBox_PlaneSurface.png b/docs/plugins/figures/tgeo/TGeoBBox_PlaneSurface.png
similarity index 100%
rename from docs/figures/plugins/tgeo/TGeoBBox_PlaneSurface.png
rename to docs/plugins/figures/tgeo/TGeoBBox_PlaneSurface.png
diff --git a/docs/figures/plugins/tgeo/TGeoTrd1_PlaneSurface.png b/docs/plugins/figures/tgeo/TGeoTrd1_PlaneSurface.png
similarity index 100%
rename from docs/figures/plugins/tgeo/TGeoTrd1_PlaneSurface.png
rename to docs/plugins/figures/tgeo/TGeoTrd1_PlaneSurface.png
diff --git a/docs/figures/plugins/tgeo/TGeoTrd2_PlaneSurface_xz.png b/docs/plugins/figures/tgeo/TGeoTrd2_PlaneSurface_xz.png
similarity index 100%
rename from docs/figures/plugins/tgeo/TGeoTrd2_PlaneSurface_xz.png
rename to docs/plugins/figures/tgeo/TGeoTrd2_PlaneSurface_xz.png
diff --git a/docs/figures/plugins/tgeo/TGeoTrd2_PlaneSurface_yz.png b/docs/plugins/figures/tgeo/TGeoTrd2_PlaneSurface_yz.png
similarity index 100%
rename from docs/figures/plugins/tgeo/TGeoTrd2_PlaneSurface_yz.png
rename to docs/plugins/figures/tgeo/TGeoTrd2_PlaneSurface_yz.png
diff --git a/docs/figures/plugins/tgeo/TGeoTube_CylinderSurface.png b/docs/plugins/figures/tgeo/TGeoTube_CylinderSurface.png
similarity index 100%
rename from docs/figures/plugins/tgeo/TGeoTube_CylinderSurface.png
rename to docs/plugins/figures/tgeo/TGeoTube_CylinderSurface.png
diff --git a/docs/figures/plugins/tgeo/TGeoTube_DiscSurface.png b/docs/plugins/figures/tgeo/TGeoTube_DiscSurface.png
similarity index 100%
rename from docs/figures/plugins/tgeo/TGeoTube_DiscSurface.png
rename to docs/plugins/figures/tgeo/TGeoTube_DiscSurface.png
diff --git a/docs/plugins/tgeo.rst b/docs/plugins/tgeo.rst
index bc3b47c5acf..65153264958 100644
--- a/docs/plugins/tgeo.rst
+++ b/docs/plugins/tgeo.rst
@@ -35,32 +35,32 @@ Examples of supported ``TGeoShape`` transformations to ``Acts::Surface`` objects
 Additionally, an option exists to split surfaces after the transformation
 has taken place by adding a splitter implementation to the ``Acts::TGeoLayerBuilder``, like the ``Acts::TGeoCylinderDiscSplitter``. This can be useful to describe e.g. a cylindrical detector with tangential planar surfaces.
 
-.. figure:: ../figures/plugins/tgeo/TGeoBBox_PlaneSurface.png
+.. figure:: figures/tgeo/TGeoBBox_PlaneSurface.png
   :width: 800
   
   Conversion of a ``TGeoBBox`` shape into a ``Acts::PlaneSurface`` with ``Acts::RectangleBounds``. All axes iterations are allowed for this conversion.
 
-.. figure:: ../figures/plugins/tgeo/TGeoTrd1_PlaneSurface.png
+.. figure:: figures/tgeo/TGeoTrd1_PlaneSurface.png
   :width: 800
   
   Conversion of a ``TGeoTrd1`` shape into a ``Acts::PlaneSurface`` with ``Acts::TrapezoidBounds``. The axes definitions need to be ``(x/X)(z/Z)(*/*)``.
 
-.. figure:: ../figures/plugins/tgeo/TGeoTrd2_PlaneSurface_xz.png
+.. figure:: figures/tgeo/TGeoTrd2_PlaneSurface_xz.png
   :width: 800
   
   Conversion of a ``TGeoTrd2`` shape into a ``Acts::PlaneSurface`` with ``Acts::TrapezoidBounds``. The axes definitions shown are ``(x/X)(z/Z)(*/*)``, the second coordinate has to be the z-axis.
 
-.. figure:: ../figures/plugins/tgeo/TGeoTrd2_PlaneSurface_yz.png
+.. figure:: figures/tgeo/TGeoTrd2_PlaneSurface_yz.png
   :width: 800
   
   Conversion of a ``TGeoTrd2`` shape into a ``Acts::PlaneSurface`` with ``Acts::TrapezoidBounds``. The axes definitions shown are ``(y/Y)(z/Z)(*/*)``, the second coordinate has to be the z-axis.
 
-.. figure:: ../figures/plugins/tgeo/TGeoTube_CylinderSurface.png
+.. figure:: figures/tgeo/TGeoTube_CylinderSurface.png
   :width: 800
   
   Conversion of a ``TGeoTube`` shape into a ``Acts::CylinderSurface`` with ``Acts::CylinderBounds``. The axes definitions has to be ``(x/X)(y/Y)(*/*)``.
 
-.. figure:: ../figures/plugins/tgeo/TGeoTube_DiscSurface.png
+.. figure:: figures/tgeo/TGeoTube_DiscSurface.png
   :width: 800
   
   Conversion of a ``TGeoTube`` shape into a ``Acts::DiscSurface`` with ``Acts::DiscBounds``.The axes definitions has to be ``(x/X)(y/Y)(*/*)``.
diff --git a/docs/requirements.txt b/docs/requirements.txt
index a0cd24aa1bd..3138a2bdcff 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -24,7 +24,7 @@ certifi==2023.7.22
     # via requests
 cffi==1.16.0
     # via cryptography
-charset-normalizer==3.3.1
+charset-normalizer==3.3.2
     # via
     #   aiohttp
     #   requests
diff --git a/docs/tracking.md b/docs/tracking.md
index 978451d6960..afbafaf7fb4 100644
--- a/docs/tracking.md
+++ b/docs/tracking.md
@@ -130,8 +130,8 @@ called *particle propagation* or *extrapolation*, is used to predict a
 particle's properties after it has travelled a certain distance. In many cases,
 the projected intersection with various types of surfaces is desired. The
 trajectory of a charged particle is governed by the [magnetic
-field](core/magnetic_field.md) through which it travels, as well as any
-[material effects](core/material.rst). In case of a homogeneous magnetic field,
+field](#magnetic-field-core) through which it travels, as well as any
+[material effects](#material-core). In case of a homogeneous magnetic field,
 and in the absence of material interaction, the particle follows a helical
 trajectory. Such a helix can be calculated purely analytically, although
 intersections require numerical methods nevertheless.
@@ -450,7 +450,7 @@ are candidates to receive a projection of the surrounding material.
 Additional artificial material layers can also be inserted to receive
 projected material.
 
-The projection procedure (see [](material_core) and [](material_howto_core)) works
+The projection procedure (see [](#material-core) and [](#material_mapping_howto_core)) works
 by extrapolating test particles using the fully detailed simulation geometry.
 During the extrapolation, the material properties of the geometry are sampled
 in small intervals. Subsequently, the same test particle is extrapolated

From bfaffe1844c7e29d9462968c89cfab4acc7f8282 Mon Sep 17 00:00:00 2001
From: felix-russo <72298366+felix-russo@users.noreply.github.com>
Date: Tue, 7 Nov 2023 10:30:45 +0100
Subject: [PATCH 4/5] docs: fix path for white paper screen shots (#2641)

---
 docs/white_papers.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/white_papers.py b/docs/white_papers.py
index 9d517fdc993..113f34bdc9e 100755
--- a/docs/white_papers.py
+++ b/docs/white_papers.py
@@ -218,11 +218,12 @@ async def pull(
 
                 repo = whp.repo
                 slug = whp.slug
-                title_page_file = config_file.parent / f"{slug}.png"
 
                 image_path = Path(__file__).parent / "white_papers" / "figures"
                 assert image_path.is_dir(), image_path
 
+                title_page_file = image_path / f"{slug}.png"
+
                 latest_release = await get_latest_release(gh, repo)
 
                 metadata_ref = None

From 7925974ae19042288d4c12b277d265859956a72c Mon Sep 17 00:00:00 2001
From: Andreas Stefl <stefl.andreas@gmail.com>
Date: Tue, 7 Nov 2023 13:51:13 +0100
Subject: [PATCH 5/5] feat: Introduce propagator stage (#2621)

Currently it is not possible to discover in which stage of propagation we are in the actors and aborters. By introducing a propagator stage enum, adding it to the state and setting it in the proagator loop this can be used in the actors and aborters.

Pulled out of https://github.com/acts-project/acts/pull/2603
---
 Core/include/Acts/Propagator/Propagator.hpp | 12 ++++++++++++
 Core/include/Acts/Propagator/Propagator.ipp |  6 ++++++
 2 files changed, 18 insertions(+)

diff --git a/Core/include/Acts/Propagator/Propagator.hpp b/Core/include/Acts/Propagator/Propagator.hpp
index 8daba511dab..a3c914a8cc0 100644
--- a/Core/include/Acts/Propagator/Propagator.hpp
+++ b/Core/include/Acts/Propagator/Propagator.hpp
@@ -32,6 +32,15 @@
 
 namespace Acts {
 
+/// @brief Different stages during propagation
+enum class PropagatorStage {
+  invalid,          ///< Invalid stage
+  prePropagation,   ///< Before the propagation
+  postPropagation,  ///< After the propagation
+  preStep,          ///< Before a step
+  postStep,         ///< After a step
+};
+
 /// @brief Simple class holding result of propagation call
 ///
 /// @tparam parameters_t Type of final track parameters
@@ -270,6 +279,9 @@ class Propagator final {
           navigation{std::move(navigationIn)},
           geoContext(topts.geoContext) {}
 
+    /// Propagation stage
+    PropagatorStage stage = PropagatorStage::invalid;
+
     /// These are the options - provided for each propagation step
     propagator_options_t options;
 
diff --git a/Core/include/Acts/Propagator/Propagator.ipp b/Core/include/Acts/Propagator/Propagator.ipp
index 79d21ac680b..d756005827b 100644
--- a/Core/include/Acts/Propagator/Propagator.ipp
+++ b/Core/include/Acts/Propagator/Propagator.ipp
@@ -20,6 +20,8 @@ auto Acts::Propagator<S, N>::propagate_impl(propagator_state_t& state,
   // Pre-stepping call to the navigator and action list
   ACTS_VERBOSE("Entering propagation.");
 
+  state.stage = PropagatorStage::prePropagation;
+
   // Navigator initialize state call
   m_navigator.initialize(state, m_stepper);
   // Pre-Stepping call to the action list
@@ -41,6 +43,7 @@ auto Acts::Propagator<S, N>::propagate_impl(propagator_state_t& state,
     // Propagation loop : stepping
     for (; result.steps < state.options.maxSteps; ++result.steps) {
       // Pre-Stepping: target setting
+      state.stage = PropagatorStage::preStep;
       m_navigator.preStep(state, m_stepper);
       // Perform a propagation step - it takes the propagation state
       Result<double> res = m_stepper.step(state, m_navigator);
@@ -57,6 +60,7 @@ auto Acts::Propagator<S, N>::propagate_impl(propagator_state_t& state,
       }
       // Post-stepping:
       // navigator post step call - action list - aborter list
+      state.stage = PropagatorStage::postStep;
       m_navigator.postStep(state, m_stepper);
       state.options.actionList(state, m_stepper, m_navigator, result, logger());
       if (state.options.abortList(state, m_stepper, m_navigator, result,
@@ -69,6 +73,8 @@ auto Acts::Propagator<S, N>::propagate_impl(propagator_state_t& state,
     ACTS_VERBOSE("Propagation terminated without going into stepping loop.");
   }
 
+  state.stage = PropagatorStage::postPropagation;
+
   // if we didn't terminate normally (via aborters) set navigation break.
   // this will trigger error output in the lines below
   if (!terminatedNormally) {