Files
Hermes Agent ed23524817 fix: harden Claro diagnostics and runtime guards
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.
2026-10-25 02:42:53 +00:00

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.