Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
a7142db
A frameless page for a site's own page, and the matrix of every item
mklarmann Nov 16, 2026
b8e5a55
chain.state leaves out identity entries whose value is None
mklarmann Nov 16, 2026
3c0a953
A matrix from a tables description; the header follows the loaded matrix
mklarmann Nov 16, 2026
d90f76e
The page's own sentences say the file's word for an item
mklarmann Nov 16, 2026
163d6b1
A file's own word for an indicator; steps from 1 without published re…
mklarmann Nov 17, 2026
20e7d1e
The grid reads like the trial dashboard: a ratio in every cell, furth…
mklarmann Nov 17, 2026
7274efd
A matrix page: chips choose the comparison, the grid first, the rest …
mklarmann Nov 17, 2026
97045e8
Review a step where it is chosen: its claim beside its effect, what i…
mklarmann Nov 17, 2026
752043b
SPEC: the line of the chosen step, the columns by what moved, the add…
mklarmann Nov 17, 2026
b1cd355
Distributions per indicator: a card each, under the matrix, as the tr…
mklarmann Nov 17, 2026
38d6767
Distributions: bar heights per card, or one scale for every card (A21)
mklarmann Nov 17, 2026
52bb73c
The review of PR 21: every verdict, no colour, missing is not still, …
mklarmann Nov 17, 2026
4ed348a
Percentiles in one precision: the fewest digits that keep every diffe…
mklarmann Nov 17, 2026
a217b5a
Merge pull request #21 from sentier-dev/page-review
mklarmann Nov 17, 2026
1f3fb2f
The page refuses a matrix that says other numbers of a listed item th…
mklarmann Nov 17, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion GLOSSARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ The words this repository uses, each in one line. [SPEC.md](SPEC.md) says the re
- **Reference unit**: the unit an item's result is per (kg, MJ, machine hour). Floors are kept apart per unit.
- **State**: one set of results. The first may be the published results; the others are builds.
- **Step**: from one state to the next, with its kind, claim, tolerance and noise.
- **Step 0**: the reproduction of the published results. The start, never the target.
- **Step 0**: the reproduction of the published results. The start, never the target. A chain that does not start from the published results has no step 0: its steps are numbered from 1.
- **Chain**: the states in order and the steps between them.
- **Pair**: one item in one indicator, before and after a step.
- **Class**: what a pair is, by one rule: agrees, within noise, differs, beyond 10x, zero reference, zero result, sign change, near zero, missing.
Expand All @@ -25,3 +25,7 @@ The words this repository uses, each in one line. [SPEC.md](SPEC.md) says the re
- **Breakdown**: what one item's result is made of, before and after one step.
- **Tier**: whether a file lists items (`items`) or holds counts only (`counts`).
- **Audience**: whether a file's writer says it may be published (`public`) or not (`local`).
- **Listed items**: the items a file holds, the worst first, up to `listed`.
- **Matrix**: every item of a local file, listed or not, in a second file the page loads after it has drawn.
- **Body**: the page as one element a site holds in its own page; its style stays inside it.
- **Drawer**: the panel of one item, at the right of the page, opened from a row.
17 changes: 15 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,10 @@ sentier-agribalyse and others):
- a chain of steps from the published results to the current build, each held against
what it claimed to move, with the whole difference split between the steps (exactly, up
to the rounding the page shows) and what nothing explains named;
- a static page that shows it, with no build step, no server and no network.
- a page that shows it: a frameless body a site holds in its own page, with a style
scoped to it that takes the site's tokens, or a page of its own with no build step, no
server and no network; a local file can carry a matrix of every item, which the page
loads after it has drawn.

The published results are checked once, at the start (step 0). Every later step is
compared with the step before it.
Expand All @@ -26,7 +29,17 @@ database. Scoring and the readers of each database stay in the projects that use
PYTHONPATH=src python3 -m sentier_diagnostics example --out build/example
```

Then open `build/example/page/index.html`. The example is made up.
Then open `build/example/page/index.html`, or `build/example/local/page/index.html` for a
local file whose page loads the matrix of every item. The example is made up.

In a site's own page:

```python
from sentier_diagnostics import page

html = page.body(data, title=False) # one <div class="sentier-diagnostics">, the file inside
assets = page.assets() # diagnostics.js and diagnostics.css, to copy
```

Install it in a project, pinned to a tag:

Expand Down
213 changes: 186 additions & 27 deletions SPEC.md

Large diffs are not rendered by default.

Loading
Loading