# Claro documentation

## Learn — start here

1. [Quick start](QUICK_START.md) — build and run your first program.
2. [First hour](FIRST_HOUR.md) — try one concept at a time.
3. [Ten lessons](../lessons/README.md) — small programs in order.
4. [Examples](../examples/) — try a quiz, guessing game, or shopping list.

## Status, evidence and safety

- [Current status](CURRENT_STATUS.md) — the short, current scope and next priorities.
- [Release status](RELEASE_STATUS.md) — dated artifact verification and publication status.
- [Classroom pilot](CLASSROOM_READINESS.md) — learner testing, not accessibility certification.
- [Reliability](RELIABILITY.md) and [runtime guards](RUNTIME_LIMITS.md) — tested boundaries, not sandbox guarantees.
- [Portability](PORTABILITY.md) and [Windows 98 / VC6](WINDOWS98.md) — compilation versus target execution.

- [Learner pilot kit](LEARNER_PILOT.md) and [blank feedback](LEARNER_FEEDBACK_TEMPLATE.md)
- [Native Windows acceptance kit](NATIVE_WINDOWS_TESTING.md)
- [Six-track progress and blockers](SIX_TRACK_STATUS.md)

## Look something up

- [Beginner syntax](SYNTAX.md) and [older compatibility forms](COMPATIBILITY.md)
- [Commands](CLI.md)
- [Errors and repairs](ERRORS.md)
- [Simple functions](SIMPLE_FUNCTIONS.md)
- [Text helpers](TEXT_HELPERS.md)
- [File and scripting helpers](PRACTICAL_SCRIPTING.md)

## For contributors

- [Build and contribute](../CONTRIBUTING.md)
- [Testing](TESTING.md) and [release checklist](FINAL_RELEASE_CHECKLIST.md)
- [Learning-first rules](LEARNING_FIRST.md) and [small active roadmap](ROADMAP.md)
- [Language specification](SPEC.md)
- [Versioning](VERSIONING.md)

## History and optional features

Older RC notes, versioned reports and expansion plans are reference, not the
active roadmap or prerequisites for learners. Existing features remain supported;
they have not been removed to simplify the teaching path.

- [Previous roadmap](history/ROADMAP_BEFORE_LEARNING_FIRST.md)
- [Previous detailed status](history/CURRENT_STATUS_BEFORE_STATUS_CLEANUP.md)
- [Preserved hardening log](history/HARDENING_BEFORE_STATUS_CLEANUP.md)

If an older plan conflicts with the current status or learning-first rules,
treat it as historical rather than as a promised feature.