Repository navigation
docs: README documented a layout that no longer exists - #49
Merged
Merged
Conversation
It is the front door and it was describing the previous two designs: `examples/` and `example-runs/` as paths, "arm" as the word for a policy, and none of `admitperf demo`, `admitperf experiments`, `compare --experiment`, the naming fields, the reporting items or the terminology section. Added, because the README never explained any of it: Naming a measurement — experiment, run, notes and provenance, and why grouping is declared rather than inferred from a directory. Moving a file should not silently change what a result claims to be. How it connects to the survey — the seven reporting items with the demo's actual statuses, including why `—` is neither a pass nor a failure: the survey's finding is that the corpus is SILENT on these, so silence has to be its own state. Plus the taxonomy axes, and why signal_structure is load-bearing — a dual gate can hold its first signal above threshold all run and never fire. Every command named in the README is now verified to exist, and the layout block lists the modules that are actually there. 179 passed, lint clean. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The front door was describing the previous two designs.
Stale:
examples/andexample-runs/as paths, "arm" as the word for a policy.Missing entirely:
admitperf demo,admitperf experiments,compare --experiment, the naming fields, the seven reporting items, terminology.Two sections that never existed
Naming a measurement —
experiment,run,notes,provenance, and why grouping is declared rather than inferred from a directory: moving a file should not silently change what a result claims to be.How it connects to the survey — the seven items with the demo's actual statuses, and why
—is neither a pass nor a failure. The survey's finding is that the corpus is silent on these, so silence has to be its own state. Plus the taxonomy axes, and whysignal_structureis load-bearing: a dual gate can hold its first signal above threshold all run and never fire, so one signal's range does not establish liveness for it.Every command named in the README is now verified to exist, and the layout block lists the modules that are actually there.
179 passed, lint clean.