FORD CI handling

Author: mzecc

.github/workflows/ci.yaml

@@ -39,6 +39,8 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
           uv-dependency-install-flags: "--all-extras --group docs"
+      - name: FORD docs
+        run: ford ford_example.md
       - name: docs
         run: |
           uv run --no-sync mkdocs build --strict

Makefile

@@ -68,16 +68,10 @@ test:  ## run the tests (re-installs the package every time so you might want to
 
 .PHONY: docs
 docs:  ## build the docs
-	@echo "Building Fortran docs"
-	uv run --no-sync ford ford_example.md
-	@echo "Building documentation"
 	uv run --no-sync mkdocs build
 
 .PHONY: docs-strict
 docs-strict:  ## build the docs strictly (e.g. raise an error on warnings, this most closely mirrors what we do in the CI)
-	@echo "Building Fortran docs"
-	uv run --no-sync ford ford_example.md
-	@echo "Building documentation"
 	uv run --no-sync mkdocs build --strict
 
 .PHONY: docs-serve

mkdocs.yml

@@ -28,6 +28,7 @@ theme:
         name: Switch to light mode
 
 plugins:
+  - ford ford_example.md
   # https://mkdocstrings.github.io/autorefs/
   - autorefs
   # Required for auto-generating our documentation stubs