30 lines
844 B
Markdown

# PBS Learn
This directory consolidates the durable operational knowledge of the PBS domain.
It exists to replace transient workflow artifacts that already served their purpose:
- open agendas,
- closed decisions,
- execution PR/plans.
The normative contract for PBS lives primarily in:
- `docs/specs/compiler-languages/pbs/`
- `docs/specs/compiler/`
`learn/` is the didactic layer:
- it explains the final model,
- highlights the tradeoffs that matter in maintenance,
- summarizes common pitfalls,
- and points back to the normative specs that should be updated or consulted first.
## Learn Set
- `01. AST and Parser Contract.md`
- `02. Name Resolution and Linking.md`
- `03. Runtime Values, Identity, and Memory Boundaries.md`
- `04. Diagnostics and Conformance Governance.md`
- `05. Globals, Lifecycle, and Published Entrypoint.md`