Upload files to "/"

README.md

@@ -2,79 +2,116 @@
 
 Beginner-friendly programming for everyone.
 
-Claro is a simple, readable programming language designed to make coding accessible to new learners, classrooms, and people with learning differences.
+Claro is a simple, readable programming language designed for:
+
+- new programmers  
+- classrooms  
+- people with learning differences  
+
+It uses clear, English-style commands and friendly error messages so you can focus on learning and creating.
 
 ---
 
-# Running Claro
+## Repository
+
+https://codeberg.org/RayPals/Claro
+
+## Download
+
+https://codeberg.org/RayPals/Claro/releases
+
+---
+
+## Features
+
+- Easy to read and write
+- English-like syntax
+- Friendly error messages
+- Simple loops and decisions
+- Reusable functions (`TEACH`, `CALL`, `RETURN`)
+- Beginner game objects (sprites)
+- Classroom-safe mode
+- Portable — no installation required
+
+---
+
+## Running Claro
 
 Interactive mode:
+
     claro
 
 Run a program:
+
     claro program.claro
 
 Classroom safe mode:
+
     claro --classroom program.claro
 
 ---
 
-# Your first program
+## Your First Program
 
-Create a file called hello.claro
+Create a file called `hello.claro`
 
-SAY "Hello, world!"
+    SAY "Hello, world!"
 
 Run it:
-claro hello.claro
+
+    claro examples/hello.claro
 
 ---
 
-# Core Commands
+## Core Commands
 
-SAY — show output
-ASK — get input
-SET — store data
-IF — make decisions
-DO — repeat a number of times
-WAIT — pause the program
+SAY — show output  
+ASK — get input  
+SET — store data  
+IF — make decisions  
+DO — repeat  
+WAIT — pause  
 
 ---
 
-# Functions with TEACH
+## Functions with TEACH
 
-TEACH add TAKES a, b
-    RETURN a + b
-LEARNED
+    TEACH add TAKES a, b
+        RETURN a + b
+    LEARNED
 
-CALL add WITH 2, 3
-SAY RESULT
+    CALL add WITH 2, 3
+    SAY RESULT
 
 ---
 
-# Sprites
+## Sprites
 
-CREATE SPRITE player
-MOVE SPRITE player TO 10 5
-SHOW SPRITE player
-HIDE SPRITE player
+    CREATE SPRITE player
+    MOVE SPRITE player TO 10 5
+    SHOW SPRITE player
+    HIDE SPRITE player
 
 ---
 
-# Project Structure
+## Building from Source
 
-bin/        → compiled Claro executable  
-docs/       → guides and classroom material  
-examples/   → sample programs  
-tests/      → test programs  
-src/        → interpreter source code  
+Linux / macOS:
+
+    gcc src/claro.c -O2 -o claro
+
+Windows (MinGW):
+
+    gcc src/claro.c -O2 -o claro.exe
 
 ---
 
-# License
+## Contributing
 
-MIT License
+https://codeberg.org/RayPals/Claro/issues
 
 ---
 
-Claro 1.0 — Simple. Readable. For everyone.
+## License
+
+MIT