[docs] switch generated docs to MkDocs

README.md

@@ -114,6 +114,33 @@ The most mature user-facing workflows are:
    `meanas.fdtd.accumulate_phasor(...)`, and compare those phasors against an
    FDFD reference on the same Yee grid.
 
+## Documentation
+
+API and workflow docs are generated from the package docstrings with
+[MkDocs](https://www.mkdocs.org/), [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/),
+and [mkdocstrings](https://mkdocstrings.github.io/).
+
+Install the docs toolchain with:
+
+```bash
+pip3 install -e './meanas[docs]'
+```
+
+Then build the docs site with:
+
+```bash
+./make_docs.sh
+```
+
+This produces:
+
+- a normal multi-page site under `site/`
+- a combined printable single-page HTML site under `site/print_page/`
+- an optional fully inlined `site/standalone.html` when `htmlark` is available
+
+The docs build uses a local MathJax bundle vendored under `docs/assets/`, so
+the rendered HTML does not rely on external services for equation rendering.
+
 Tracked examples under `examples/` are the intended starting points:
 
 - `examples/fdtd.py`: broadband FDTD pulse excitation, phasor extraction, and a