Development
This section covers contributor workflows: building, testing, updating oracle data, and finding the relevant implementation.
Start with the workflow, not the architecture
Most contributors should start with Build from source and Test matrix. Architecture details are useful after you know which surface or formula family you are changing.
Workflows
| Task | Page |
|---|---|
| Build locally | Build from source |
| Run tests | Test matrix |
| Add Excel oracle data | Oracle contribution |
Glossary: oracle data
Values captured from a real Excel build and committed as golden files. Oracle tests recalculate the same workbooks with Formulon and compare. See Oracle testing.
Code map
| Area | Where to look |
|---|---|
| C++ calculation core | C++ core |
| Per-surface bindings | Bindings |
| Internal shape | Architecture |
| Browser package limits | Size budgets |
| Release mechanics | Release checklist |
Operational work for Formulon is mostly about reproducibility: package every surface from the same core revision, keep oracle data current, record accepted divergences, and verify cross-surface parity.