NCAR · grantfirl · Apr 16, 2026 · Feb 19, 2026 · Feb 19, 2026 · Feb 19, 2026
@@ -0,0 +1,109 @@
+name: Doxygen GitHub Pages Deploy Action
+
+on:
+  push:
+    branches:
+      - main
+      - scidocs_hsd_aqua
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+
+    - name: Checkout current ccpp-physics code
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+        submodules: recursive
+
+    - name: Install Doxygen + Graphviz + LaTeX
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y doxygen graphviz perl texlive-latex-base texlive-latex-extra texlive-fonts-recommended texlive-bibtex-extra
+
+    - name: Verify installations
+      run: |
+        which perl
+        which bibtex
+        doxygen --version
+
+    - name: Build HSD docs
+      run: |
+        cd physics/docs
+        doxygen ccpphsd_doxyfile
+
+    - name: Checkout SCM V7
+      uses: actions/checkout@v4
+      with:
+        repository: NCAR/ccpp-scm
+        ref: v7.0.1
+        path: scm_repo
+        submodules: recursive
+
+    - name: Generate metadata tables (SCM V7)
+      run: |
+        pwd
+        cd scm_repo
+        ls
+
+        export PYTHONPATH=$(pwd)/ccpp/framework/scripts:$(pwd)/ccpp/framework/scripts/parse_tools
+
+        ./ccpp/framework/scripts/metadata2html.py -c ccpp/config/ccpp_prebuild_config.py
+
+        mkdir -p ccpp/physics/physics/docs/html/V7
+        mv ccpp/physics/physics/docs/*.html ccpp/physics/physics/docs/html/V7
+
+    - name: Build V7 docs
+      run: |
+        cd scm_repo/ccpp/physics/physics/docs
+        doxygen ccpp_doxyfile
+        mv doc/html/* html/V7/
+
+    - name: Checkout ufs-community SRWv3 branch
+      uses: actions/checkout@v4
+      with:
+        repository: ufs-community/ccpp-physics
+        ref: release/srw-v3
+        path: srw_repo
+        submodules: recursive
+
+    - name: Build SRWv3 docs
+      run: |
+        cd srw_repo/physics/docs
+        doxygen ccppsrw_doxyfile
+        mkdir -p ../../../physics/docs/html/SRWv3
+        mv doc/html/* ../../../physics/docs/html/SRWv3/
+
+    - name: Checkout main branch again for landing page
+      uses: actions/checkout@v4
+      with:
+        ref: scidocs_hsd_aqua
+        path: main_repo
+
+    - name: Build landing page
+      run: |
+        cd main_repo/physics/docs
+        doxygen mainpage_doxyfile
+        cp -r html/* $GITHUB_WORKSPACE/physics/docs/html/
+
+    - name: Setup Pages
+      uses: actions/configure-pages@v5
+
+    - name: Upload artifact
+      uses: actions/upload-pages-artifact@v3
+      with:
+        path: physics/docs/html
+
+    - name: Deploy to GitHub Pages
+      id: deployment
+      uses: actions/[email protected]
@@ -55,3 +55,8 @@ html.dark-mode .bordered_image object[type="image/svg+xml"] /* doxygen 1.9.3 */
 .title_screenshot .caption {
     display: none;
 }
+
+#back-to-landing {
+  padding: 10px 20px;
+  font-size: 14px;
+}
@@ -41,6 +41,20 @@
 </head>
 <body>
 
+<div id="back-to-landing">
+  <a href="/ccpp-physics/">← Back to Documentation Home</a>
+</div>
+
+<script>
+  if (window.location.pathname.endsWith('/ccpp-physics/') ||
+      window.location.pathname.endsWith('/ccpp-physics/index.html')) {
+    document.addEventListener("DOMContentLoaded", function() {
+      var el = document.getElementById("back-to-landing");
+      if (el) el.style.display = "none";
+    });
+  }
+</script>
+
 <!-- https://tholman.com/github-corners/ -->
 <a href="https://github.com/ufs-community/ccpp-physics" class="github-corner" title="View source on GitHub" target="_blank" rel="noopener noreferrer">
     <svg viewBox="0 0 250 250" width="60" height="60" style="position: absolute; top: 0; border: 0; right: 0; z-index: 99;" aria-hidden="true">

@@ -74,7 +74,7 @@ PROJECT_ICON           =
 # entered, it will be relative to the location where Doxygen was started. If
 # left blank the current directory will be used.
 
-OUTPUT_DIRECTORY       = doc
+OUTPUT_DIRECTORY       = html
 
 # If the CREATE_SUBDIRS tag is set to YES then Doxygen will create up to 4096
 # sub-directories (in 2 levels) under the output directory of each output format
@@ -840,7 +840,7 @@ CITE_BIB_FILES         = library.bib
 # launching external tools will then become
 # PATH=/Library/TeX/texbin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
 
-EXTERNAL_TOOL_PATH     =
+EXTERNAL_TOOL_PATH     = /usr/bin
 
 #---------------------------------------------------------------------------
 # Configuration options related to warning and progress messages
@@ -1127,7 +1127,7 @@ EXCLUDE_SYMBOLS        =
 # command).
 
 EXAMPLE_PATH           = pdftxt/RE7 \
-                         doc/html
+                         pdftxt
 
 # If the value of the EXAMPLE_PATH tag contains directories, you can use the
 # EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp and
@@ -1173,7 +1173,7 @@ IMAGE_PATH             = img
 # need to set EXTENSION_MAPPING for the extension otherwise the files are not
 # properly processed by Doxygen.
 
-INPUT_FILTER           =
+INPUT_FILTER           = 
 
 # The FILTER_PATTERNS tag can be used to specify filters on a per file pattern
 # basis. Doxygen will compare the file name with each pattern and apply the
@@ -1186,7 +1186,7 @@ INPUT_FILTER           =
 # need to set EXTENSION_MAPPING for the extension otherwise the files are not
 # properly processed by Doxygen.
 
-FILTER_PATTERNS        =
+FILTER_PATTERNS        = 
 
 # If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using
 # INPUT_FILTER) will also be used to filter the input files that are used for
@@ -1341,7 +1341,7 @@ GENERATE_HTML          = YES
 # The default directory is: html.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
-HTML_OUTPUT            = html
+HTML_OUTPUT            = V7
 
 # The HTML_FILE_EXTENSION tag can be used to specify the file extension for each
 # generated HTML page (for example: .htm, .php, .asp).
@@ -2809,7 +2809,7 @@ INTERACTIVE_SVG        = YES
 # found. If left blank, it is assumed the dot tool can be found in the path.
 # This tag requires that the tag HAVE_DOT is set to YES.
 
-DOT_PATH               = /opt/homebrew/bin
+DOT_PATH               =
 
 # The DOTFILE_DIRS tag can be used to specify one or more directories that
 # contain dot files that are included in the documentation (see the \dotfile

@@ -42,7 +42,7 @@ DOXYFILE_ENCODING      = UTF-8
 # title of most generated pages and in a few other places.
 # The default value is: My Project.
 
-PROJECT_NAME           = "CCPP SciDoc for Idealized Regional TC Capability"
+PROJECT_NAME           = "CCPP SciDoc for HSD Capabilities"
 
 # The PROJECT_NUMBER tag can be used to enter a project or revision number. This
 # could be handy for archiving the generated documentation or if some version
@@ -74,7 +74,7 @@ PROJECT_ICON           =
 # entered, it will be relative to the location where Doxygen was started. If
 # left blank the current directory will be used.
 
-OUTPUT_DIRECTORY       = doc
+OUTPUT_DIRECTORY       = html
 
 # If the CREATE_SUBDIRS tag is set to YES then Doxygen will create up to 4096
 # sub-directories (in 2 levels) under the output directory of each output format
@@ -984,20 +984,27 @@ WARN_LOGFILE           =
 # spaces. See also FILE_PATTERNS and EXTENSION_MAPPING
 # Note: If this tag is empty the current directory is searched.
 
-INPUT                  = pdftxt/HAFS_TC_suite.txt  \
+INPUT                  = pdftxt/HSD_overview.txt \
+                         pdftxt/Idealized_TC.txt \
+                         pdftxt/Aquaplanet.txt \
+                         pdftxt/HAFS_TC_suite.txt  \
+                         pdftxt/GFS_v17_p8_ugwpv1_aquaplanet_suite.txt \
+                         pdftxt/suite_input.nml.txt \
+                         pdftxt/acronyms.txt   \
                          pdftxt/GFS_RRTMG.txt \
                          pdftxt/GFS_SFCLYR.txt \
+                         pdftxt/GFS_NSST.txt \
                          pdftxt/GFS_OCEAN.txt \
                          pdftxt/NOAH_LSM.txt \
+                         pdftxt/NOAHMP_LSM.txt \
                          pdftxt/GFS_SFCSICE.txt \
                          pdftxt/GFS_SATMEDMFVDIFQ.txt \
                          pdftxt/UGWPv0.txt \
+                         pdftxt/GFS_OZPHYS.txt \
                          pdftxt/GFS_H2OPHYS.txt \
                          pdftxt/GFS_SAMFdeep.txt \
                          pdftxt/GFS_SAMFshal.txt \
                          pdftxt/THOMPSON.txt \
-                         pdftxt/suite_input.nml.txt \
-                         pdftxt/acronyms.txt   \ 
                          ../MP \
                          ../CONV \
                          ../GWD \
@@ -1135,7 +1142,7 @@ EXCLUDE_SYMBOLS        =
 # command).
 
 EXAMPLE_PATH           = pdftxt/RE300 \
-                         doc/html
+                         pdftxt
 
 # If the value of the EXAMPLE_PATH tag contains directories, you can use the
 # EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp and
@@ -1358,7 +1365,7 @@ GENERATE_HTML          = YES
 # The default directory is: html.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
-HTML_OUTPUT            = html
+HTML_OUTPUT            = HSD
 
 # The HTML_FILE_EXTENSION tag can be used to specify the file extension for each
 # generated HTML page (for example: .htm, .php, .asp).
@@ -1428,7 +1435,8 @@ HTML_STYLESHEET        =
 HTML_EXTRA_STYLESHEET  = _doxygen/doxygen-awesome.css \
                          _doxygen/doxygen-awesome-sidebar-only.css \
                          _doxygen/doxygen-awesome-sidebar-only-darkmode-toggle.css \
-                         _doxygen/doxygen-awesome-ccpp.css
+                         _doxygen/doxygen-awesome-ccpp.css \
+                         _doxygen/custom.css
 
 # The HTML_EXTRA_FILES tag can be used to specify one or more extra images or
 # other source files which should be copied to the HTML output directory. Note

@@ -1450,7 +1450,8 @@ HTML_STYLESHEET        =
 HTML_EXTRA_STYLESHEET  = _doxygen/doxygen-awesome.css \
                          _doxygen/doxygen-awesome-sidebar-only.css \
                          _doxygen/doxygen-awesome-sidebar-only-darkmode-toggle.css \
-                         _doxygen/doxygen-awesome-ccpp.css
+                         _doxygen/doxygen-awesome-ccpp.css \
+                         _doxygen/custom.css
 
 # The HTML_EXTRA_FILES tag can be used to specify one or more extra images or
 # other source files which should be copied to the HTML output directory. Note

@@ -0,0 +1,30 @@
+# CCPP Physics Scientific Documentation
+
+The Common Community Physics Package (CCPP) provides scientific documentation for the physics suites and parameterizations used across a variety of atmospheric modeling applications. The documentation describes the scientific basis, configuration options, and implementation details for the parameterizations included in the CCPP physics suites for different modeling systems and use cases.
+
+- [CCPP Physics V7.0.0 Scientific Documentation](./V7/)
+- [CCPP Physics UFS Hierarchical System Development (HSD) Scientific Documentation](./HSD/)
+- [CCPP Physics SRW v3.0.0 Scientific Documentation](./SRWv3/)
+
+For more information about the CCPP including Release Information, Technical Documentation, and Code, please visit the 
+<a href="https://dtcenter.org/community-code/common-community-physics-package-ccpp" target="_blank">CCPP website</a>, hosted by the Developmental Testbed Center (DTC).
+
+## Acknowledgements
+
+CCPP team would like to express our deepest gratitude for UFS physics developers' contribution to the
+development of CCPP-Physics.
+\n We would also like to give special thanks to:
+
+- \b NOAA \b NWS \b Environmental \b Modeling \b Center
+- \b NOAA \b OAR \b Global \b Systems \b Laboratory
+- \b NOAA \b OAR \b Physical \b Sciences \b Laboratory
+- \b NOAA \b OAR \b National \b Severe \b Storms \b Laboratory
+- \b NOAA \b OAR \b Atlantic \b Oceanographic \b & \b Meteorological \b Laboratory
+- \b Atmospheric \b and \b Environmental \b Research, \b Inc.
+- \b Joint \b Center \b for \b Satellite \b Data \b Assimilation
+- \b NASA \b Goddard \b Space \b Flight \b Center
+- \b U.S. \b Naval \b Research \b Laboratory
+- \b NOAA \b OAR \b Geophysical \b Fluid \b Dynamics \b Laboratory
+
+for their support and contribution for this CCPP scientific documentation (SciDoc).
+\n Thanks also to the CCPP SciDoc Team at the Developmental Testbed Center: Man Zhang, Ligia Bernardet, Mike Kavulich, and Tracy Hertneky.