refactor: keep Claro in one strict C89 source file

2026-10-20 16:12:26 +00:00
parent dd7e8b8b20
commit 8ea2f772cd
59 changed files with 8353 additions and 1289 deletions
@@ -0,0 +1,32 @@
+# 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.
+
+## Look something up
+
+- [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 test](../CONTRIBUTING.md)
+- [Learning-first rules](LEARNING_FIRST.md)
+- [Current roadmap](ROADMAP.md)
+- [Detailed implementation status](CURRENT_STATUS.md)
+- [Language specification](SPEC.md)
+- [Versioning](VERSIONING.md)
+
+## History and optional features
+
+Older RC notes, versioned validation reports, and platform-expansion plans
+remain in this directory for reference. They are not prerequisites for learning
+and are not the active roadmap. The [previous roadmap](history/ROADMAP_BEFORE_LEARNING_FIRST.md)
+records the earlier direction. Existing features have not been removed.