Skip to content

Novice browser user-test, ACE triage, and Option B' fixes - #27

Merged
mzargham merged 24 commits into
mainfrom
novice-test-bprime
Oct 3, 2026
Merged

mzargham merged 24 commits into
mainfrom
novice-test-bprime

Conversation

@mzargham

@mzargham mzargham commented Oct 3, 2026 •

Copy link
Copy Markdown
Member

Summary

  • Two longitudinal novice browser read-throughs of the live site (52-54 pages each) with ACE interviews and triage: zero blocking findings; round 1's prose complaints retracted as an inline-code extraction artifact (DL-100..DL-102). Raw diaries, ACE notes and the combined synthesis are in decisions/user-testing/.
  • S13 fix: removed a builder-facing skill-file citation from two judgment-record criteria fields, the stored records, and two exercise templates.
  • user-testing skill: four evidence rules for browser read-through diaries (DL-103).
  • Option B' (DL-104): Ch2 judgment-record framing paragraph; glossary links at first use of abstract, mechanism, MoE, MoP; stage headings on the Ch10-01 traceability graph notebook; a store-derived record-dependency figure on Ch10-02; three glossary terms proposed (conjugated port, feature chain, judgment record), still proposed, not linked from chapters.
  • ACE rulings on the glossary questions: DL-105..DL-108. Closing entry with follow-ups: DL-109.

Test plan

  • uv run pytest tests/ glossary/tests/ -q: 448 passed
  • uv run python -m glossary check: 0 errors (7 source-absent warnings plus the intended "2 load-bearing term(s) have no confirmed definition yet" while Z's confirmation is pending)
  • uv run python scripts/check_construction.py --check: all 10 chapters consistent
  • Each code/content change independently reviewed on a different model than its builder; notebook diffs minimal (no whole-notebook re-execution)
  • Z: run uv run python -m glossary verify-sources on a machine with the registered PDFs, then confirm the three proposed terms

…MoE/MoP criteria fields

Removes the leaked "(architecture-layers skill)" citation from the
criteria/framing_criteria fields learners read in
chapters/ch03-measures/01-moe-definition.ipynb and
chapters/ch06-recursive-decomp/02-second-level.ipynb (source and matching
stored output), from the same hint string in the two mirrored exercise
templates, exercises/ch03/exercise.ipynb and exercises/ch06/exercise.ipynb
(source only, since those cells are unexecuted), and from the persisted
judgment-record store entries that carried the same text,
decisions/judgment-records/AC-C03.json and AC-C06.json (criteria field
only; content_hash is derived from model source, not criteria, so
staleness checks are unaffected). Replaced with "(SEBoK's MoE/MoP
distinction, PDF 1562)", matching this tutorial's existing citation style
and the glossary's confirmed MoE/MoP locator. No model-construction logic
changed.
…n with SEBoK locator in MoE/MoP criteria fields
…ill-editor fix

# Conflicts:
#	decisions/log.md
…mechanism, abstract to glossary at first use
… load-bearing flags, conjugated-port locator, Hawkins verification)
@review-notebook-app

Copy link
Copy Markdown

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

@mzargham
mzargham merged commit 00d2547 into main Oct 3, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant