Skip to content

Render --help=cookbook from the help model - #389

Merged
helly25 merged 1 commit into
mainfrom
help/port-cookbook-topic
Aug 8, 2026
Merged

Render --help=cookbook from the help model#389
helly25 merged 1 commit into
mainfrom
help/port-cookbook-topic

Conversation

@helly25

@helly25 helly25 commented Aug 8, 2026

Copy link
Copy Markdown
Owner

Third slice of retiring the imperative prose-topic renderers (EPIC #154; follows #387 stats, #388 config).

What

  • Route --help=cookbook (aliases examples / recipes) through TopicReference to the existing BuildExamples() model section - the same nodes already in --help=full / --man / --markdown.
  • Delete RenderCookbook and its RenderHelp branch.

Effect

The standalone --help=cookbook now wraps to --width and stays in lock-step with the full reference (single SOT = CookbookRecipes()). No XFF.md change - --markdown already rendered BuildExamples.

Test

bazel test //xff/... (85) and --config=xff_full (90) green. help_render_test (cookbook now model-rendered) + help_topic_test.sh (model intro wording) updated.

Remaining: notice, license (verbatim), help-guide.

Route --help=cookbook (aliases examples / recipes) through TopicReference to the
existing BuildExamples() model section - the same nodes already in --help=full /
--man / --markdown - so the standalone topic wraps to --width and stays in lock-step
with the full reference (one SOT, CookbookRecipes()). Delete RenderCookbook and its
RenderHelp branch. No XFF.md change (--markdown already rendered BuildExamples).
Update help_render_test (cookbook now model-rendered) and help_topic_test.sh (model
intro wording).
@helly25
helly25 enabled auto-merge (squash) August 8, 2026 11:13
@helly25
helly25 merged commit 674d4a6 into main Aug 8, 2026
9 checks passed
@helly25
helly25 deleted the help/port-cookbook-topic branch August 8, 2026 11:23
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