book-project

The mdBook creation process uses reader calibration to adapt content structure and complexity to the audience's proficiency level. It assesses target reader knowledge during the structure proposal phase to ensure the generated table of contents matches their learning needs.

Planning a large technical book is handled through progressive validation rounds that reveal the table of contents and opening chapters incrementally. This scales from a 5-page pamphlet up to a 50-chapter reference.

You can generate educational content combining code and prose by running the structure proposal workflow. It requires a YAML frontmatter with name and description at the root, and outputs structured chapters aligning with planning-tiers and prose guidelines.

mdBook generation works for both short pamphlets and full reference books by scaling the structure proposal to the desired size. It supports projects ranging from 5 pages to 50 chapters with progressive validation.

Limitations of automated mdBook structure proposals include the strict requirement for YAML frontmatter at the root directory. You must also follow planning-tiers and prose guidelines, and manual configuration is needed to extend behavior with references, scripts, or assets.