practice-writer

What problem does it solve?

Defines a standard for creating technical training exercises by outlining a consistent frontmatter, chapter structure, and exercise sequence to ensure quality and reusability across courses.

Core Features & Use Cases

• Establishes a modular framework for building exercises with mandatory frontmatter, a toc placeholder, and sections such as Overview, Problem, Answer Format, and Answer Key to guide learners.
• Enforces the use of hands-on steps via the :::step directive to describe interactive procedures and supports a tiered difficulty flow (basic, intermediate, advanced).
• Specifies file-naming conventions (chapter-XX.md) and output layout (dist/exercise) to streamline publishing and versioning of practice chapters.

Quick Start

Create a new chapter file named chapter-01.md with the required frontmatter and three mandatory sections following the prescribed structure.