index.md

Crispy Documentation

This documentation follows the Diataxis model:

• tutorials/: learning-oriented, step-by-step onboarding
• how-to/: goal-oriented operational guides
• reference/: factual technical details (API, protocol, memory map)
• explanation/: design rationale and architecture decisions

Tutorials

• Flash the bootloader for the first time

How-to Guides

• Hardware test setup (Picoprobe + Pico target)
• Upload firmware
• Run integration tests
• Recover a device

Reference

• CLI crispy-upload
• USB protocol
• Memory map
• Boot data format

Explanation

• Architecture
• AI-assisted development concept
• Boot bank selection and rollback
• Development methodology
• Architecture decisions index