docs: Fully doxygen based documentation

.github/workflows/docs.yml

@@ -13,7 +13,7 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
-  docs:
+  docs-old:
     runs-on: ubuntu-latest
     env:
       DOXYGEN_WARN_AS_ERROR: FAIL_ON_WARNINGS
@@ -52,5 +52,44 @@ jobs:
 
       - uses: actions/upload-artifact@v6
         with:
-          name: acts-docs
+          name: acts-docs-old
           path: docs/old/_build/html/
+
+  docs:
+    runs-on: ubuntu-latest
+    # container: ghcr.io/acts-project/ubuntu2404:83
+    env:
+      DOXYGEN_WARN_AS_ERROR: FAIL_ON_WARNINGS
+      DOXYGEN_VERSION: "1.15.0"
+      DOXYGEN_HASH: "0ec2e5b2c3cd82b7106d19cb42d8466450730b8cb7a9e85af712be38bf4523a1"
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install doxygen
+        run: |
+          curl -SL https://acts.web.cern.ch/ci/doxygen/doxygen-${{ env.DOXYGEN_VERSION }}.linux.bin.tar.gz -o doxygen-${{ env.DOXYGEN_VERSION }}.linux.bin.tar.gz
+          echo "${{ env.DOXYGEN_HASH }}  doxygen-${{ env.DOXYGEN_VERSION }}.linux.bin.tar.gz" | sha256sum -c -
+          tar xf doxygen-${{ env.DOXYGEN_VERSION }}.linux.bin.tar.gz
+          mv doxygen-${{ env.DOXYGEN_VERSION }}/bin/doxygen /usr/local/bin/doxygen
+
+      - name: Install APT packages
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y graphviz texlive-bibtex-extra libeigen3-dev libboost-dev cmake
+
+      - name: Configure
+        run: >
+          cmake -B build -S . -DACTS_BUILD_DOCS=ON
+
+      - name: Build documentation
+        run: >
+          cmake --build build --target docs
+
+      - uses: actions/upload-artifact@v6
+        id: artifact-upload-step
+        with:
+          name: acts-docs
+          path: build/docs/html
+
+      - name: Documentation display
+        run: echo 'https://acts-herald.app.cern.ch/view/${{ github.repository }}/${{ steps.artifact-upload-step.outputs.artifact-id }}/index.html'

Alignment/include/ActsAlignment/Kernel/Alignment.hpp

@@ -21,14 +21,14 @@
 #include <vector>
 
 namespace ActsAlignment {
+
 using AlignedTransformUpdater =
     std::function<bool(Acts::DetectorElementBase*, const Acts::GeometryContext&,
                        const Acts::Transform3&)>;
 ///
 /// @brief Options for align() call
 ///
 /// @tparam fit_options_t The fit options type
-///
 template <typename fit_options_t>
 struct AlignmentOptions {
   /// Deleted default constructor

CI/check_unused_files.py

@@ -62,6 +62,11 @@ def main():
         "CompressedIO.h",
         # Files for python binding generation
         "tgeo_aux.py.in",
+        "serve.py",
+        "SNIPPETS.md",
+        "todo.md",
+        "bugs.md",
+        "deprecated.md",
     )
 
     suffix_header = (
@@ -83,6 +88,9 @@ def main():
     suffix_doc = (
         ".md",
         ".rst",
+        ".dox",
+        ".html",
+        ".bib",
     )
     suffix_other = (
         "",
@@ -99,6 +107,7 @@ def main():
         ".toml",
         ".txt",
         ".yml",
+        ".xml",
     )
     suffix_allowed = (
         suffix_header

CI/codespell_ignore.txt

@@ -20,3 +20,5 @@ strack
 te
 vart
 writet
+OptionA
+thirdparty

CI/physmon/workflows/physmon_trackfinding_1muon.py

@@ -97,7 +97,7 @@ def run_ckf_tracking(label, seeding):
             setup.trackingGeometry,
             setup.field,
             TrackSmearingSigmas(  # only used by SeedingAlgorithm.TruthSmeared
-                # zero eveything so the CKF has a chance to find the measurements
+                # zero everything so the CKF has a chance to find the measurements
                 loc0=0,
                 loc0PtA=0,
                 loc0PtB=0,

CMakeLists.txt

@@ -591,7 +591,6 @@ endif()
 # other dependencies
 if(ACTS_BUILD_DOCS)
     find_package(Doxygen ${_acts_doxygen_version} REQUIRED)
-    find_package(Sphinx REQUIRED)
 endif()
 
 # core library, core plugins, and other components