fix: stabilize learning path, reliability and legacy Windows builds

Unify beginner syntax while preserving compatibility, repair ownership and parser guards, add verified distribution tooling and VC6 Windows 98 build inputs, and clarify documentation and release status. Preserve DOS build-input line endings and exclude generated binaries/caches.
This commit is contained in:
Hermes Agent
2026-10-20 22:40:19 +00:00
parent 8ea2f772cd
commit d555071406
73 changed files with 2403 additions and 730 deletions
+36 -28
View File
@@ -1,35 +1,43 @@
# Classroom Readiness Checklist
# Classroom pilot checklist
Claro v2026.10.20.160950 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.
**Status: ready for supervised learner testing, not classroom certification.**
Accessibility for learners with learning disabilities is a design goal and is
**not yet validated** by intended learners. Passing tests does not establish it.
Use [current status](CURRENT_STATUS.md) for scope, not older feature roadmaps.
## Ready to test
## Before a session
- Beginner console programs
- Interactive examples
- Variables, math, choices, loops, lists, maps, functions
- 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 a build whose platform was actually tested; check `claro --version`.
On the legacy Windows build the executable is `claro98.exe`.
- Run `claro test` and `claro validate` in the extracted project folder.
- Prepare a writable practice folder and explain how to stop/close a stuck run.
- Use only reviewed, trusted scripts. Claro is not a sandbox and runs with the
learner's permissions; do not collect sensitive information in exercises.
## Use with caution
## Observe the first hour
- Advanced scripts
- Large programs
- Graphics/game examples
- Remote networking examples
- Package registry or publishing workflows
- Concurrency examples beyond documented safe task patterns
1. Run [hello](../lessons/01_hello.claro) and change its message.
2. Try [input](../lessons/02_ask_name.claro), variables and simple arithmetic.
3. Introduce one decision, then one small loop, at the learner's pace.
4. Follow the [ten lessons](../lessons/README.md) and [first-hour guide](FIRST_HOUR.md).
5. Try a small quiz; ask the learner to explain what changed and why.
6. Introduce a harmless mistake, run `claro check`, and observe whether the
message identifies the right line and suggests an understandable repair.
## Recommended testing session
Show one recommended spelling per concept. Do not introduce classes, typing,
packages, networking, concurrency or graphics as prerequisites to first programs.
1. Build Claro or use the included executable.
2. Run `claro --version` and confirm `Claro v2026.10.20.160950`.
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`.
## Record feedback
- Can the learner start, run, change and save a program without repeated coaching?
- Which instructions, words, prompts or errors cause confusion?
- Are examples short enough? Is the expected output obvious?
- Can the learner recover from a mistake and understand what a loop does?
- What presentation, pacing or assistive-technology adjustments help this person?
Record observations without claiming one design suits every disability. Get
consent before retaining feedback and avoid unnecessary personal/health data.
Make one small improvement, then repeat learner testing.
Platform checks, hosted release verification and accessibility feedback are
separate milestones. See [release status](RELEASE_STATUS.md).