book.yaml: a chapter can name the part it opens, and the TOC groups by it - #27
Merged
Conversation
…y it Prompt to Production is divided into five parts and is by some distance the easiest of the four books in its series to navigate. The other three have the same five-part structure -- each names its parts in chapter 1's prose -- and none of it was structural: book.yaml carried the parts as YAML *comments*, and the rendered table of contents was a flat list of sixteen chapters. `part` sits on the chapter that opens the part rather than in a separate list, so a chapter cannot end up in two parts or in none. A book that declares no parts renders exactly as before. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This was referenced Sep 3, 2026
Merged
Merged
Merged
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
1 participant
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.
Closes the tooling half of alpibrusl/prompt-to-production#27.
Production is divided into five parts and is the easiest of its series to navigate. The other three books already have the same five-part structure — each names its parts in chapter 1's prose — and none of it was structural.
book.yamlcarried them as YAML comments, and the rendered TOC was a flat list of sixteen chapters.partsits on the chapter that opens the part rather than in a parallel list, so a chapter cannot end up in two parts or in none. A book declaring no parts renders exactly as before — there is a test for that.Three tests, and all four books build EPUB, HTML and PDF with their parts grouped.
🤖 Generated with Claude Code