docs: consolidate canonical specs and preserve PBS reference IDs
This commit is contained in:
@@ -260,8 +260,11 @@ If you are new to the codebase, this order is usually the fastest path:
|
||||
|
||||
Important reference surfaces:
|
||||
|
||||
- `docs/specs/compiler/`: shared compiler specifications
|
||||
- `docs/specs/packer/`: packer specifications
|
||||
- [Specification guide](docs/specs/README.md): domain ownership and reading order
|
||||
- [General compiler](docs/specs/compiler/README.md): shared compiler specifications
|
||||
- [PBS](docs/specs/compiler-languages/pbs/README.md): language and SDK specifications
|
||||
- [Studio](docs/specs/studio/README.md): shell, workspaces and integration contracts
|
||||
- [Packer](docs/specs/packer/README.md): packer specifications
|
||||
- `docs/vm-arch/`: VM and ISA architecture references
|
||||
|
||||
These documents are the long-term normative source for behavior and contracts. When code and docs diverge, fix the divergence explicitly instead of relying on tribal knowledge.
|
||||
|
||||
Reference in New Issue
Block a user