From 6923da318f7cc3b11bc9f8d19db9cd57b69ea0c6 Mon Sep 17 00:00:00 2001 From: Ariel Harlap <3870784+aharlap@users.noreply.github.com> Date: Mon, 19 Oct 2026 19:19:21 -0400 Subject: [PATCH 1/3] Document write-distractors in .prax --- patterns/write-distractors/README.md | 42 ++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) diff --git a/patterns/write-distractors/README.md b/patterns/write-distractors/README.md index cc47268..b6b05f9 100644 --- a/patterns/write-distractors/README.md +++ b/patterns/write-distractors/README.md @@ -24,6 +24,48 @@ Use it when learners know enough to answer from memory and explain common mistak 5. Compare your question with the author's. Each wrong option names its mistaken idea. A check mark shows a matching label. The summary counts matching and extra labels. 6. Select "Start over" to clear your work. +## Write this in .prax + +In `.prax`, start a `write-distractors` block with the question and put exactly one `answer:` before the items. Each `:: Misconception label` item pairs a mistaken idea with one `option:` containing a wrong answer. Studio generates the IDs; authors do not write them. The unquoted `count` setting accepts 1 to 5 and sets how many wrong options the learner writes. It defaults to 2, independently of the number of authored items. + +Studio does not publish this block yet. The grammar accepts these examples, but publication is currently refused. + +Studio's planned learner activity is private practice saved only on the learner's device, with no scores or LMS records. The comparison matches misconception labels, not the meaning of the learner's writing, and does not grade answers. Overlong entries show an error and keep the full text. Learners can use browser print. Native PDF workbooks include answers only when an answer sheet is requested. + +English: + +```prax +--- +lang: en +--- +# Button names + +::: write-distractors What should a button's accessible name tell the user? {count=2} +answer: The action the button performs. +:: Appearance replaces purpose +option: The button's colour. +:: Position replaces purpose +option: The button's position on the page. +::: +``` + +French, using the default count: + +```prax +--- +lang: fr +--- +# Le texte des liens + +::: write-distractors Que doit indiquer le texte d'un lien vers un formulaire d'inscription ? +answer: La destination ou le but du lien. +:: Une consigne vague suffit +option: Seulement les mots « cliquez ici ». +:: La couleur suffit à expliquer la destination +option: Seulement la couleur du lien. +::: +``` + ## Evidence Giving your own answer helps you remember more than reading one. The average effect was 0.40 standard deviations across 86 studies ([Bertsch et al., 2007](https://doi.org/10.3758/BF03193441)). University students wrote questions about a lecture. A week later, they recalled about as much as students who answered practice questions ([Ebersbach, Feierabend and Nazari, 2020](https://doi.org/10.1002/acp.3639)). Students who wrote multiple-choice questions for peers tended to do better in exams. Those studies show a link, not that writing questions caused better scores ([Hardy et al., 2014](https://doi.org/10.1080/09500693.2014.916831)). From 0de0c6d249e2ec101af465d9eba49499d5110243 Mon Sep 17 00:00:00 2001 From: Ariel Harlap <3870784+aharlap@users.noreply.github.com> Date: Mon, 19 Oct 2026 19:25:11 -0400 Subject: [PATCH 2/3] Clarify planned Studio support and French typography --- patterns/write-distractors/README.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/patterns/write-distractors/README.md b/patterns/write-distractors/README.md index b6b05f9..6c87b1c 100644 --- a/patterns/write-distractors/README.md +++ b/patterns/write-distractors/README.md @@ -28,9 +28,11 @@ Use it when learners know enough to answer from memory and explain common mistak In `.prax`, start a `write-distractors` block with the question and put exactly one `answer:` before the items. Each `:: Misconception label` item pairs a mistaken idea with one `option:` containing a wrong answer. Studio generates the IDs; authors do not write them. The unquoted `count` setting accepts 1 to 5 and sets how many wrong options the learner writes. It defaults to 2, independently of the number of authored items. -Studio does not publish this block yet. The grammar accepts these examples, but publication is currently refused. +Write at least one item; `private`, `scored` and `required` settings are not accepted, and the block cannot go in an assessment group. -Studio's planned learner activity is private practice saved only on the learner's device, with no scores or LMS records. The comparison matches misconception labels, not the meaning of the learner's writing, and does not grade answers. Overlong entries show an error and keep the full text. Learners can use browser print. Native PDF workbooks include answers only when an answer sheet is requested. +Studio does not publish this block yet and cannot yet preview it or include it in a PDF workbook. The grammar accepts these examples, but publication is currently refused. + +Studio's planned learner activity will be private practice saved only on the learner's device, with no scores or LMS records. The comparison will match misconception labels, not the meaning of the learner's writing, and will not grade answers. Overlong entries will show an error and keep the full text. Planned browser printing will let learners print their work. The planned PDF workbook will leave space to write; answers will appear only in an answer sheet the author requests. English: @@ -57,10 +59,10 @@ lang: fr --- # Le texte des liens -::: write-distractors Que doit indiquer le texte d'un lien vers un formulaire d'inscription ? +::: write-distractors Que doit indiquer le texte d’un lien vers un formulaire d’inscription ? answer: La destination ou le but du lien. :: Une consigne vague suffit -option: Seulement les mots « cliquez ici ». +option: Seulement les mots « cliquez ici ». :: La couleur suffit à expliquer la destination option: Seulement la couleur du lien. ::: From fd2841e85af03ca1f2551993a1798762babda398 Mon Sep 17 00:00:00 2001 From: Ariel Harlap <3870784+aharlap@users.noreply.github.com> Date: Tue, 20 Oct 2026 05:51:35 -0400 Subject: [PATCH 3/3] Document published Studio support for write-distractors --- patterns/write-distractors/README.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/patterns/write-distractors/README.md b/patterns/write-distractors/README.md index 6c87b1c..6c72e01 100644 --- a/patterns/write-distractors/README.md +++ b/patterns/write-distractors/README.md @@ -30,11 +30,9 @@ In `.prax`, start a `write-distractors` block with the question and put exactly Write at least one item; `private`, `scored` and `required` settings are not accepted, and the block cannot go in an assessment group. -Studio does not publish this block yet and cannot yet preview it or include it in a PDF workbook. The grammar accepts these examples, but publication is currently refused. +In Studio, this is private practice saved only on the learner's device, with no scores or LMS records. The comparison matches misconception labels, not the meaning of the learner's writing, and does not grade answers. Overlong entries show an error and keep the full text. Browser print includes current writing and only content already revealed. The PDF workbook includes the question, instructions and writing space. An answer sheet, included only when the author requests it, adds the right answer and numbered labels with their paired wrong options. -Studio's planned learner activity will be private practice saved only on the learner's device, with no scores or LMS records. The comparison will match misconception labels, not the meaning of the learner's writing, and will not grade answers. Overlong entries will show an error and keep the full text. Planned browser printing will let learners print their work. The planned PDF workbook will leave space to write; answers will appear only in an answer sheet the author requests. - -English: +English (Praxity Studio from commit `5b16180`, 2026-10-20): ```prax --- @@ -51,7 +49,7 @@ option: The button's position on the page. ::: ``` -French, using the default count: +French, using the default count (Praxity Studio from commit `5b16180`, 2026-10-20): ```prax ---