Docs @ 93e3d09

Author: MFC Action

documentation/architecture.html

@@ -401,7 +401,7 @@ <h1 class="doxsection"><a class="anchor" id="autotoc_md13"></a>
 <li><b>Add the module to <span class="tt">docs/module_categories.json</span></b> so it appears in this page</li>
 </ol>
 <p>Follow the pattern of existing modules like <span class="tt">m_body_forces</span> (simple) or <span class="tt">m_viscous</span> (more involved) as a template.</p>
-<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-03-14</div> </div></div><!-- contents -->
+<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-03-15</div> </div></div><!-- contents -->
 </div><!-- PageDoc -->
 </div><!-- doc-content -->
 <div id="page-nav" class="page-nav-panel">

documentation/case_constraints.html

@@ -1424,7 +1424,7 @@ <h2 class="doxsection"><a class="anchor" id="physics-warnings"></a>
 </table>
 <hr  />
 <p>💡 <b>Tip:</b> If you encounter a validation error, check the relevant section above or review <a href="https://github.com/MFlowCode/MFC/blob/master/toolchain/mfc/case_validator.py"><span class="tt">case_validator.py</span></a> for complete validation logic.</p>
-<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-03-14</div> </div></div><!-- contents -->
+<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-03-15</div> </div></div><!-- contents -->
 </div><!-- PageDoc -->
 </div><!-- doc-content -->
 <div id="page-nav" class="page-nav-panel">

documentation/cli-reference.html

@@ -727,20 +727,20 @@ <h2 class="doxsection"><a class="anchor" id="autotoc_md62"></a>
 Development Commands</h2>
 <h3 class="doxsection"><a class="anchor" id="lint"></a>
 lint</h3>
-<p>Run pylint and unit tests on MFC's toolchain Python code.</p>
+<p>Run ruff and unit tests on MFC's toolchain Python code.</p>
 <p><b>Usage:</b> <span class="tt">./mfc.sh lint [OPTIONS]</span></p>
 <p><b>Options:</b></p>
 <table class="markdownTable">
 <tr class="markdownTableHead">
 <th class="markdownTableHeadNone">Option  </th><th class="markdownTableHeadNone">Description  </th><th class="markdownTableHeadNone">Default  </th></tr>
 <tr class="markdownTableRowOdd">
-<td class="markdownTableBodyNone"><span class="tt">--no-test</span>  </td><td class="markdownTableBodyNone">Skip running unit tests (only run pylint).  </td><td class="markdownTableBodyNone">-  </td></tr>
+<td class="markdownTableBodyNone"><span class="tt">--no-test</span>  </td><td class="markdownTableBodyNone">Skip running unit tests (only run ruff).  </td><td class="markdownTableBodyNone">-  </td></tr>
 </table>
 <p><b>Examples:</b></p>
-<div class="fragment"><div class="line"># Run pylint and unit tests</div>
+<div class="fragment"><div class="line"># Run ruff and unit tests</div>
 <div class="line">./mfc.sh lint</div>
 <div class="line"> </div>
-<div class="line"># Run only pylint (skip unit tests)</div>
+<div class="line"># Run only ruff (skip unit tests)</div>
 <div class="line">./mfc.sh lint --no-test</div>
 </div><!-- fragment --><hr  />
 <h3 class="doxsection"><a class="anchor" id="format"></a>
@@ -952,7 +952,7 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md78"></a>
 <h3 class="doxsection"><a class="anchor" id="autotoc_md79"></a>
 Debug Logging (<span class="tt">-d, --debug-log</span>)</h3>
 <p>Enables debug logging for the Python toolchain (mfc.sh internals). This is for troubleshooting the build system, not the MFC simulation code.</p>
-<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-03-14</div> </div></div><!-- contents -->
+<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-03-15</div> </div></div><!-- contents -->
 </div><!-- PageDoc -->
 </div><!-- doc-content -->
 <div id="page-nav" class="page-nav-panel">

documentation/contributing.html

@@ -751,16 +751,17 @@ <h2 class="doxsection"><a class="anchor" id="autotoc_md114"></a>
 <p>Every push to a PR triggers CI. Understanding the pipeline helps you fix failures quickly.</p>
 <h3 class="doxsection"><a class="anchor" id="autotoc_md115"></a>
 Lint Gate (runs first, blocks all other jobs)</h3>
-<p>All four checks must pass before any builds start:</p>
+<p>All five checks must pass before any builds start:</p>
 <ol type="1">
 <li><b>Formatting</b> — <span class="tt">./mfc.sh format</span> (auto-handled by pre-commit hook)</li>
 <li><b>Spelling</b> — <span class="tt">./mfc.sh spelling</span></li>
-<li><b>Toolchain lint</b> — <span class="tt">./mfc.sh lint</span> (Python code quality)</li>
+<li><b>Toolchain lint</b> — <span class="tt">./mfc.sh lint</span> (ruff + Python unit tests)</li>
 <li><b>Source lint</b> — checks for:<ul>
 <li>Raw <span class="tt">!$acc</span> or <span class="tt">!$omp</span> directives (must use Fypp GPU macros)</li>
 <li>Double-precision intrinsics (<span class="tt">dsqrt</span>, <span class="tt">dexp</span>, <span class="tt">dble</span>, etc.)</li>
 </ul>
 </li>
+<li><b>Doc references</b> — validates documentation cross-references</li>
 </ol>
 <h3 class="doxsection"><a class="anchor" id="autotoc_md116"></a>
 Build and Test Matrix</h3>

documentation/examples.html

@@ -388,7 +388,7 @@ <h2 class="doxsection"><a class="anchor" id="autotoc_md273"></a>
 <h3 class="doxsection"><a class="anchor" id="autotoc_md274"></a>
 Final Condition (Density)</h3>
 <p><img src="final-2D_forward_facing_step-example.png" alt="" class="inline"/></p>
-<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-03-14</div> </div></div><!-- contents -->
+<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-03-15</div> </div></div><!-- contents -->
 </div><!-- PageDoc -->
 </div><!-- doc-content -->
 <div id="page-nav" class="page-nav-panel">

documentation/parameters.html

@@ -1566,7 +1566,7 @@ <h2 class="doxsection"><a class="anchor" id="autotoc_md393"></a>
 <div class="line"> </div>
 <div class="line"># Filter by type</div>
 <div class="line">./mfc.sh params -t real weno</div>
-</div><!-- fragment --><div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-03-14</div> </div></div><!-- contents -->
+</div><!-- fragment --><div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-03-15</div> </div></div><!-- contents -->
 </div><!-- PageDoc -->
 </div><!-- doc-content -->
 <div id="page-nav" class="page-nav-panel">

documentation/physics_constraints.html

@@ -623,7 +623,7 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md443"></a>
 <li>FFT WRT incompatible with cylindrical coordinates</li>
 <li>FFT WRT requires global dimensions divisible by 2</li>
 </ul>
-<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-03-14</div> </div></div><!-- contents -->
+<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-03-15</div> </div></div><!-- contents -->
 </div><!-- PageDoc -->
 </div><!-- doc-content -->
 <div id="page-nav" class="page-nav-panel">