Add docs/QUICK_START.md from Claro v1.17.26 zip

This commit is contained in:
RayPals
2026-06-01 00:54:26 +02:00
parent d95501b27e
commit 558b8146a0
+104
View File
@@ -0,0 +1,104 @@
# Claro Quick Start Guide
Programming Made Simple
## What is Claro?
Claro is a small scripting language designed for beginners. It uses readable commands like `SAY`, `ASK`, `SET`, and `TEACH`.
## 1. Show a message
```claro
SAY "Hello!"
```
Run it:
```bash
./claro hello.claro
```
## 2. Ask a question
```claro
ASK "What is your name?" AS name
SAY "Hello " + name
```
## 3. Remember information
```claro
SET score TO 10
SAY score
```
## 4. Make a choice
```claro
IF score >= 5
SAY "Good job!"
ELSE
SAY "Try again."
ENDIF
```
## 5. Repeat something
```claro
DO 3 TIMES
SAY "Practice"
DONE
```
## 6. Use a list
```claro
SET items TO LIST
ADD "milk" TO items
ADD "bread" TO items
FOR EACH item IN items
SAY item
DONE
```
## 7. Teach a function
```claro
TEACH greet TAKES name
RETURN "Hello " + name
LEARNED
CALL greet WITH "Alex"
SAY RESULT
```
## 8. Save a file
```claro
WRITE FILE "note.txt" WITH "Hello from Claro"
READ FILE "note.txt" AS note
SAY note
```
## Good first project: a quiz
```claro
SAY "Tiny Quiz"
ASK "What is 2 + 2?" AS answer
IF answer = 4
SAY "Correct!"
ELSE
SAY "The answer is 4."
ENDIF
```
## Tips
- Use `SAY` to show information.
- Use `ASK` to get information.
- Use `SET` to remember information.
- Use `IF` when the program needs to choose.
- Use `DO` or `FOR` when something repeats.
- Use `TEACH` to make reusable code.