Swift DocC interactive tutorials

DocC interactive tutorials provide multi-page, step-by-step interactive learning experiences with synchronized code diffs, canvas media, and interactive knowledge checks—identical to Apple's official tutorials (SwiftUI Tutorials, SwiftData Essentials).

References

• references/pedagogical-patterns.md: Consult when designing curriculum progression, authoring single-file micro-prototypes, capping sections with the 3–5 step rule, authoring milestone wrap-up pages, or validating the starter/finisher compilability contract.
• references/myers-diff-mechanics.md: Consult when authoring sequential code listings in Resources/code/, preventing or diagnosing shifted closing brace highlight defects, or running audit-docc-highlights.py.
• references/directives-catalog.md: Consult for the complete syntax reference and parent-child nesting rules of @Tutorials, @Tutorial, @Article, @Section, @Steps, @Step, @Code, and @Assessments.

1. Directory structure and file hierarchy

DocC tutorials must be placed inside a .docc documentation catalog adhering to this exact directory hierarchy: