Edit authoring.md: Exercise headers need a real question_text() chunk - #35
Merged
davidkane9 merged 1 commit intoAug 11, 2026
Merged
Conversation
guide/authoring.md §6.5 already forbade a fake placeholder
question_text() ("no command to run, just Continue"), but a tutorial
(08-seguro-popular Courage Exercise 10) shipped a plainer variant of
the same mistake: an ### Exercise N heading followed only by prose and
a formula, with no question_text() chunk at all. Nothing in the guide
explicitly named that as the same violation, so it read as compliant
on a literal pass even though it broke the rule's spirit.
Make the rule airtight: every ### Exercise N heading must be followed
by an actual question_text() chunk before the next ###/## heading,
full stop, whether the missing piece is a fake placeholder or nothing
at all. Add an explicit pre-submission self-check instruction.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
guide/authoring.md§6.5 already forbids a fake placeholderquestion_text()("no command to run, just Continue"). But 08-seguro-popular's Courage Exercise 10 shipped a different variant of the same mistake: an### Exercise Nheading followed only by prose and a formula, with noquestion_text()chunk . Nothing in the guide explicitly named that as the same violation, so it read as compliant on a literal pass even though it broke the rule's spirit.### Exercise Nheading must be followed by an actualquestion_text()chunk before the next###/##headingAlso adds an explicit pre-submission self-check instruction (scan every Exercise header, confirm a question_text() chunk follows it).
the fake exercise heading was removed, its formula content folded into the following exercise's preamble, and the rest of the Courage section renumbered (Exercise 10 -> 13, chunk labels
courage-10throughcourage-13).