ESCOMP · samsrabin · May 28, 2026 · May 28, 2026 · May 28, 2026 · May 28, 2026
diff --git a/.gitmodules b/.gitmodules
@@ -124,7 +124,7 @@ fxDONOTUSEurl = https://github.com/ESMCI/mpi-serial
 [submodule "doc-builder"]
 path = doc/doc-builder
 url = https://github.com/ESMCI/doc-builder
-fxtag = v3.2.1
+fxtag = v3.3
 fxrequired = ToplevelOptional
 # Standard Fork to compare to with "git fleximod test" to ensure personal forks aren't committed
 fxDONOTUSEurl = https://github.com/ESMCI/doc-builder
diff --git a/doc/doc-builder b/doc/doc-builder
diff --git a/doc/source/tech_note/Crop_Irrigation/CLM50_Tech_Note_Crop_Irrigation.md b/doc/source/tech_note/Crop_Irrigation/CLM50_Tech_Note_Crop_Irrigation.md
diff --git a/doc/source/tech_note/Crop_Irrigation/CLM50_Tech_Note_Crop_Irrigation.rst b/doc/source/tech_note/Crop_Irrigation/CLM50_Tech_Note_Crop_Irrigation.rst
diff --git a/doc/source/tech_note/References/CLM50_Tech_Note_References.rst b/doc/source/tech_note/References/CLM50_Tech_Note_References.rst
@@ -684,6 +684,10 @@ Jacksonetal1996: E., and Schulze, E. D. 1996. A global analysis of root distribu
 
 Jackson, T.L., Feddema, J.J., Oleson, K.W., Bonan, G.B., and Bauer, J.T. 2010. Parameterization of urban characteristics for global climate modeling. Annals of the Association of American Geographers. 100:848-865.
 
+.. _Jägermeyretal2021:
+
+Jägermeyr, J., Müller, C., Minoli, S., Ray, D., & Siebert, S. (2021). GGCMI Phase 3 crop calendar [Data set]. Zenodo. https://doi.org/10.5281/zenodo.5062513. See also: https://www.isimip.org/gettingstarted/input-data-bias-adjustment/details/115/
+
 .. _JenkinsonColeman2008:
 
 Jenkinson, D. and Coleman, K. 2008. The turnover of organic carbon in subsoils. Part 2. Modelling carbon turnover. European Journal of Soil Science 59:400-413.
@@ -772,6 +776,10 @@ Koven, C.D., G. Hugelius, D.M. Lawrence, and W.R. Wieder, 2017: Higher climatolo
 
 Kucharik, C.J., J.M. Norman, and S.T. Gower, 1998. Measurements of branch area and adjusting leaf area index indirect measurements. Agricultural and Forest Meteorology 91.1, pp. 69-88.
 
+.. _kucharik2003:
+
+Kucharik, C.J., 2003. Evaluation of a Process-Based Agro-Ecosystem Model (Agro-IBIS) across the U.S. Corn Belt: Simulations of the Interannual Variability in Maize Yield. Earth Interactions 7, paper 14. DOI: 10.1175/1087-3562(2003)007<0001:EOAPAM>2.0.CO;2.
+
 .. _Kuchariketal2000:
 
 Kucharik, C.J., Foley, J.A., Delire, C., Fisher, V.A., Coe, M.T., Lenters, J.D., Young-Molling, C., and Ramankutty, N. 2000. Testing the performance of a dynamic global ecosystem model: water balance, carbon balance, and vegetation structure. Global Biogeochem. Cycles 14: 795–825.
@@ -1297,6 +1305,10 @@ Purves, D.W. et al.,  2008. Predicting and understanding forest dynamics using a
 
 Qian, T et al.,  2006. Simulation of global land surface conditions from 1948 to 2004: Part I: Forcing data and evaluations. J. Hydrometeorology 7, pp. 953-975.
 
+.. _Rabinetal2023:
+
+Rabin, S., Sacks, W., Lombardozzi, D., Xia, L. & Robock, A., 2023. Observation-based sowing dates and cultivars significantly affect yield and irrigation for some crops in the Community Land Model (CLM5). Geosci. Model Dev. 16, 7253–7273 (2023). DOI 10.5194/gmd-16-7253-2023. https://gmd.copernicus.org/articles/16/7253/2023/
+
 .. _RamankuttyFoley1998:
 
 Ramankutty, N., and Foley, J. A., 1998. Characterizing patterns of global land use: An analysis of global croplands data. Global Biogeochemical Cycles, 12, 667-685.

diff --git a/doc/source/tech_note/index.rst b/doc/source/tech_note/index.rst
@@ -42,7 +42,7 @@ CLM Technical Note
    Plant_Mortality/CLM50_Tech_Note_Plant_Mortality.rst
    Fire/CLM50_Tech_Note_Fire.rst
    Methane/CLM50_Tech_Note_Methane.rst
-   Crop_Irrigation/CLM50_Tech_Note_Crop_Irrigation.rst
+   Crop_Irrigation/CLM50_Tech_Note_Crop_Irrigation.md
    Transient_Landcover/CLM50_Tech_Note_Transient_Landcover.rst
    DGVM/CLM50_Tech_Note_DGVM.rst
    BVOCs/CLM50_Tech_Note_BVOCs.rst

diff --git a/...source/users_guide/running-special-cases/Running-with-custom-crop-calendars.rst b/...source/users_guide/running-special-cases/Running-with-custom-crop-calendars.rst
@@ -1,7 +1,7 @@
-.. running-with-custom-crop-calendars:
-
 .. include:: ../substitutions.rst
 
+.. _running-with-custom-crop-calendars:
+
 =======================================
  Running with custom crop calendars
 =======================================

diff --git a/doc/source/users_guide/using-clm-tools/paramfile-tools.md b/doc/source/users_guide/using-clm-tools/paramfile-tools.md
@@ -5,6 +5,7 @@ This guide describes the features and usage of the `query_paramfile` and `set_pa
 
 Note that you need to have the `ctsm_pylib` conda environment activated to use these tools. See Sect. {numref}`using-ctsm-pylib` for more information.
 
+(query-paramfile)=
 ## `query_paramfile`
 **Purpose:** Print the values of one or more parameters from a CTSM parameter file (netCDF format).
 
@@ -32,6 +33,7 @@ Print values for specific PFTs:
 tools/param_utils/query_paramfile -i paramfile.nc -p needleleaf_evergreen_temperate_tree,c4_grass medlynintercept medlynslope
 ```
 
+(set-paramfile)=
 ## `set_paramfile`
 **Purpose:** Change values of one or more parameters in a CTSM parameter file (netCDF format).
 

diff --git a/doc/substitutions.py b/doc/substitutions.py
@@ -60,4 +60,28 @@
     "dirmenu_entry": "clmdoc",
     "description": "One line description of project.",
     "category": tex_category,
-}
+}
+
+###############################
+### Purely custom variables ###
+###############################
+
+nonparamfile_disclaimer_md = (
+    "**Note:** The values here should be up-to-date with those used in {{version_label}},"
+    " but there may be mistakes."
+)
+nonparamfile_disclaimer_rst = (
+    "**Note:** The values here should be up-to-date with those used in |version_label|,"
+    " but there may be mistakes."
+)
+
+paramfile_disclaimer_md = (
+    nonparamfile_disclaimer_md +
+    " If you want to check the values for your version, use"
+    " [](query-paramfile) on the `paramfile` for your case."
+)
+paramfile_disclaimer_rst = (
+    nonparamfile_disclaimer_rst +
+    " If you want to check the values for your version, use"
+    " :ref:`query-paramfile` on the ``paramfile`` for your case."
+)