development overview

This page is generated from docs/development/index.md. Do not edit it directly; change the repository source and let automation publish the Wiki.

Development guide

Read these pages in this order when changing the code:

1. Architecture
2. Source and API map
3. LUND data contract and provenance
4. Sampling models and random numbers
5. External geometry and detector inputs
6. Contributing
7. Developer build reference
8. Scientific validation boundaries

Then use adding a physical-input adapter for that specific extension, or Wiki publishing when changing documentation and its publication. The getting-started path remains the operating guide; developer pages explain the implementation behind it.

Use Preparing a publication PR to copy reviewed application files from dev onto release-candidate and open a PR into main.

When changing behavior, update the code, command-line help, profiles, tutorials, and Wiki source together. Readers should not have to guess which description matches the current program.