Skip to content

Document write-distractors in .prax - #50

Closed
aharlap wants to merge 3 commits into
mainfrom
docs/write-distractors-prax-section
Closed

aharlap wants to merge 3 commits into
mainfrom
docs/write-distractors-prax-section

Conversation

@aharlap

@aharlap aharlap commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

Adds a "Write this in .prax" section for write-distractors, with original English and French examples. Covers the question, answer and misconception/option syntax, generated IDs, count settings, device-only practice, label comparison, browser printing, PDF workbooks and author constraints. The French example uses narrow no-break spaces and typographic apostrophes.

Validation:

  • node --test: 391 passed.
  • npm run typecheck, npm run types, npm run types:check, npm run budget, git diff --check: passed.
  • Both README examples passed Studio's grammar reader at 5b161802a88787009b4edf418c1fb46c26ff143e, with zero diagnostics and no runtime refusal. Full author content, generated IDs, explicit count and default count were checked.

The Studio publication condition is met by commit 5b16180, merged on 2026-10-20. Both examples now cite that first-supporting commit, have been rechecked, and describe current behaviour. Browser print includes current writing and only revealed content. The PDF workbook includes the question, instructions and writing space; an explicitly requested answer sheet adds the right answer and numbered labels with their paired wrong options. This PR stays a draft pending owner approval.

Review: 0/2/4; fixes 6. Opus 5.5: syntax and learner behaviour match Studio's reference; both examples are original and compile with only the expected publication refusal; nothing private in the README, commit or body. Fixed French spacing inside guillemets and before punctuation (narrow no-break spaces, typographic apostrophes), present-tense print and PDF claims (now marked planned; Studio can't preview or put the block in a PDF workbook yet), the PDF wording, the draft condition in the body, and added the author constraints.

@aharlap

aharlap commented Oct 20, 2026

Copy link
Copy Markdown
Contributor Author

Closing without merging. The .prax syntax and examples for every block now live in the Praxity Studio format reference (prax-format), not in the pattern READMEs. These write-distractors examples will be added there.

🤖 Generated with Claude Code

@aharlap aharlap closed this Oct 20, 2026
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