docs: clarify Claro v1 status and validation

This commit is contained in:
Hermes Agent
2026-06-07 03:03:13 -06:00
parent 0da1095c03
commit 1e0ea06d21
74 changed files with 2351 additions and 336 deletions
+15 -8
View File
@@ -1,6 +1,6 @@
# Classroom Readiness Checklist
Claro RC3 is suitable for early classroom-style testing, but not final 1.0.
Claro v1.18.26 is suitable for beginner classroom-style testing of the stable console-language foundation. Advanced platform features should still be introduced carefully and only after the basics are comfortable.
## Ready to test
@@ -10,19 +10,26 @@ Claro RC3 is suitable for early classroom-style testing, but not final 1.0.
- Simple files and JSON
- Friendly `check` command
- Windows and Linux/macOS build paths
- Local project/package workflow basics
- Offline networking lessons with `claro://` URLs
## Use with caution
- Advanced scripts
- Large programs
- Graphics/game examples
- Package/module workflows beyond simple imports
- Remote networking examples
- Package registry or publishing workflows
- Concurrency examples beyond documented safe task patterns
## Recommended testing session
1. Build Claro.
2. Run `claro test`.
3. Run `lessons/01_hello.claro`.
4. Run `lessons/02_ask_name.claro`.
5. Run `examples/quiz.claro`.
6. Deliberately mistype `SAY` as `PRNT` and run `claro check`.
1. Build Claro or use the included executable.
2. Run `claro --version` and confirm `Claro v1.18.26`.
3. Run `claro test`.
4. Run `claro validate`.
5. Run `lessons/01_hello.claro`.
6. Run `lessons/02_ask_name.claro`.
7. Run `examples/quiz.claro`.
8. Deliberately mistype `SAY` as `PRNT` and run `claro check`.
9. Try one foundation feature example, such as `examples/objects_classes.claro` or `examples/networking.claro`.