Preserve source locations, validate malformed JSON, and add opt-in resource limits. Include executable error-guide coverage, learner pilot materials, native Windows acceptance helpers, and updated CI/documentation.
51 lines
2.2 KiB
Markdown
51 lines
2.2 KiB
Markdown
# 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.
|