Repository navigation
0.3.0
The first release shaped by somebody else's deck.
Someone built a presentation with the published skill, in their own project, against a brief this repository had no part in. That deck now ships as a third worked example, and running the gates over it found four defects that neither deck written here could have exposed. Two more turned up when a person opened it and clicked.
If you have a deck built before this release
Nothing new is required of a deck's content. The shared shell moved, so the shell check will report on any deck built earlier. Both fixes are one command.
| What newly fails | The smallest edit |
|---|---|
shell.py check: COMPONENTS differs from shell/components.css and SCRIPT differs from shell/deck.js, on every deck built before this release |
python tools/deck/shell.py sync <deck> --write |
TOKENS on any deck built before 0.2.3 that never declared --qv-measure. That requirement is 0.2.3's, arriving with the quick-view measure. What is new here is that a gate can finally see it, so you will read it as this release's failure and it is the previous one's |
python tools/deck/shell.py tokens <deck> --write |
Neither command touches a per-deck region. sync rewrites only the shared blocks, and tokens adds only the declarations that are missing, at the shipped theme's value.
New commands
shell.py syncrefreshes a deck's shared shell after a release. Before this, every release broke every deck in the wild and the only advice was to rebuild.shell.py tokensdeclares the values the new shell reads.check_all.pyruns every checker a clone receives against every deck this repository ships, and ends with a partition: each one ran, was skipped with a stated reason, or failed. A checker in none of those three fails the run.
Fixed in the published plugin
Found by running the gates over the adopter's deck:
- The upgrade path reported success and left the deck failing the theme gate. The shell it installs reads a token the deck never declared, and
syncmust not write into a per-deck region. - The content gate charged a deck for what its quoted sources said. 122 of 152 supposed deck figures came out of quotations.
- The control that opens a quoted source shipped with no minimum target size, so the 24 px accessibility floor held only by luck of the surrounding type scale.
- The figure binder could not bind a value whose label sits in the next table cell.
Found by opening the deck and clicking, which no check here reaches:
- The quick view reopened at the previous document's scroll position, so asking for a source you had never seen dropped you most of the way down it.
- A colophon filed as an argument slide, so its contents card took that stage's label and icon and the stage census counted a slide that argues nothing.
The example
examples/measure-first/ ships with two specifications, five source documents and two process models. The case, the company and every figure in it were invented for a training exercise and are published with the author's permission, renamed, with the training context removed. The analysis is untouched.
It is the only deck in the folder that was not written against this repository's own rules by whoever was also holding them.