docs: replace ephemeral workflow references with durable lessons
This commit is contained in:
@@ -15,7 +15,7 @@ It focuses on:
|
||||
|
||||
Operational policies such as capabilities, fault classes, determinism, GC interaction, budgeting, and blocking are split into a companion chapter.
|
||||
|
||||
Per `DEC-0009`, debug tooling and certification are host-owned concerns. This chapter therefore excludes general-purpose guest-visible debug syscalls from the canonical public ABI.
|
||||
Debug tooling and certification are host-owned concerns. This chapter therefore excludes general-purpose guest-visible debug syscalls from the canonical public ABI. The rationale is explained in [Host-Owned Debug Boundaries and Cheap Machine Diagnostics](../../../discussion/lessons/DSC-0012-perf-runtime-introspection-syscalls/LSN-0034-host-owned-debug-boundaries.md).
|
||||
|
||||
## 1 Design Principles
|
||||
|
||||
@@ -246,7 +246,7 @@ ordering model.
|
||||
|
||||
### Bank diagnostics surface (`bank`, v1)
|
||||
|
||||
`DEC-0009` narrows the public bank contract:
|
||||
The public bank contract is bounded:
|
||||
|
||||
- `bank.info(bank_type) -> (used_slots, total_slots)` is the only surviving public bank diagnostic shape in v1;
|
||||
- `bank.info` exists only as a cheap deterministic operational summary aligned with the slot-first bank telemetry contract from [`15-asset-management.md`](15-asset-management.md);
|
||||
@@ -256,10 +256,13 @@ ordering model.
|
||||
|
||||
### Render surfaces (`composer`, `gfx2d`, `gfxui`, v1)
|
||||
|
||||
`DEC-0030` splits logical render production from render implementation. Public
|
||||
Logical render production is separate from render implementation. Public
|
||||
render syscalls mutate app-mode-specific domain buffers. They do not directly
|
||||
publish a framebuffer and do not call host presentation APIs.
|
||||
|
||||
[Render Workers Publish Frames, Hosts Present Them](../../../discussion/lessons/DSC-0042-real-render-worker-establishment/LSN-0049-render-worker-publication-boundary.md)
|
||||
explains the ownership and publication model.
|
||||
|
||||
The canonical flow is:
|
||||
|
||||
```text
|
||||
|
||||
Reference in New Issue
Block a user