docs: the glossary defines answers, sweeps, relations and assumptions, and no longer shows build taking a Program

[FBumann]

Prompt: Look into our glossary. I think It needs some updates.

Note

The following content was generated by AI.

The glossary was last touched at alpha.334 (#1647), and several releases since then made it wrong. The worst case is the chain diagram, which drew check ──▶ Program ──▶ build, but build now refuses a Program. This PR fixes what is wrong and defines the terms the docs use without defining them. It is the first of five stacked PRs; the four renames build on it.

What changed

Wrong, now fixed

• The chain diagram now runs spec → build → Model → solve → Result, with check → Program as a side branch for reading the plan. The Spec and Program entries say to keep the Spec (lanes.py refuses a Program).
• Result listed evaluate(name). It takes an expression.
• Model called row(...) and diagnostics() sinks. They read the model; they don't solve it.
• Tables was missing qmatrix.
• The verbs section was missing evaluate, one of the five verbs the architecture page lists.
• Buildable is Mapping, not dict.

Added

• Answer, used about 400 times in src/ and docs/.
• A Sweeps section: axis, slice, key, the sweep's answer type, carry. solve_over and held/spilled move into it.
• Relation, Assumption, Formulation, Digest, a sink's capability, and check(spec, sink).

Checked: every new link points to a heading that exists. The site build was not run.

🤖 Generated with Claude Code

https://claude.ai/code/session_01VgkRT9Kpb2iNvL6dpV8VER

---

Generated by Claude Code

[codspeed]

Merging this PR will not alter performance

🆕 24 new benchmarks
⏩ 82 skipped benchmarks¹

Performance Changes

	Benchmark	BASE	HEAD	Efficiency
🆕	test_emit[commitment-s-specsolve-highs]	N/A	2 MB	N/A
🆕	test_emit[commitment-s-specsolve-lp]	N/A	2.6 MB	N/A
🆕	test_emit[dispatch-s-specsolve-highs]	N/A	12.4 MB	N/A
🆕	test_emit[dispatch-s-specsolve-lp]	N/A	18.1 MB	N/A
🆕	test_emit[fleet-s-specsolve-highs]	N/A	21.9 MB	N/A
🆕	test_emit[fleet-s-specsolve-lp]	N/A	26.2 MB	N/A
🆕	test_emit[nodal-s-specsolve-highs]	N/A	4.9 MB	N/A
🆕	test_emit[nodal-s-specsolve-lp]	N/A	5.9 MB	N/A
🆕	test_emit[profiled-s-specsolve-highs]	N/A	21.1 MB	N/A
🆕	test_emit[profiled-s-specsolve-lp]	N/A	24.3 MB	N/A
🆕	test_emit[sector-s-specsolve-highs]	N/A	5.3 MB	N/A
🆕	test_emit[sector-s-specsolve-lp]	N/A	5.3 MB	N/A
🆕	test_emit[storage-s-specsolve-highs]	N/A	16.9 MB	N/A
🆕	test_emit[storage-s-specsolve-lp]	N/A	21.7 MB	N/A
🆕	test_emit[transport-s-specsolve-highs]	N/A	15.7 MB	N/A
🆕	test_emit[transport-s-specsolve-lp]	N/A	19.9 MB	N/A
🆕	test_window[commitment-s-specsolve-highs]	N/A	1.6 MB	N/A
🆕	test_window[dispatch-s-specsolve-highs]	N/A	11.3 MB	N/A
🆕	test_window[fleet-s-specsolve-highs]	N/A	17.4 MB	N/A
🆕	test_window[nodal-s-specsolve-highs]	N/A	4.7 MB	N/A
...	...	...	...	...

ℹ️ Only the first 20 benchmarks are displayed. Go to the app to view all benchmarks.

---

_{Comparing claude/glossary-update (1f3d1d1) with main (85ebcd2)²}

Footnotes

1. 82 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

2. No successful run was found on main (50c976e) during the generation of this report, so 85ebcd2 was used instead as the comparison base. There might be some changes unrelated to this pull request in this report. ↩

[read-the-docs-community]

Documentation build overview

📚 lpspec | 🛠️ Build #34745128 | 📁 Comparing 1f3d1d1 against latest (ecf1019)

  🔍 Preview build  

3 files changed

± about/changelog/index.html
± reference/glossary/index.html
± examples/pypsa_ladder/rung_10_quadratic_costs/index.html

[read-the-docs-community]

Documentation build overview

📚 specsolve | 🛠️ Build #34745129 | 📁 Comparing 1f3d1d1 against latest (ecf1019)

  🔍 Preview build  

3 files changed

± about/changelog/index.html
± reference/glossary/index.html
± examples/pypsa_ladder/rung_10_quadratic_costs/index.html