Contributing

Development workflow

uv sync --group dev
$env:PYTHONPATH = "src"
$env:MPLBACKEND = "Agg"
.\.venv311\Scripts\python -m pytest tests\synthetic tests\retrieval -q

Repository conventions

• Migration coordination belongs in ROADMAP.md and AGENTS.md.
• User-facing documentation belongs under docs/.
• Generated artifacts should stay in ignored folders such as artifacts/ or dist/.
• Run RAW/NetCDF tests in chunks on Windows to avoid temp-folder permission issues.

Documentation

GitHub Pages is published by the docs GitHub Actions workflow. Static pages live in docs/; the workflow copies them into site/, regenerates documentation figures, generates the API reference with pdoc, and uploads site/ as the Pages artifact.

For a local figure preview after visual or synthetic-signal changes:

$env:PYTHONPATH = "src"
$env:MPLBACKEND = "Agg"
.\.venv\Scripts\python scripts\generate_docs_figures.py