From 558b8146a0ae88557480e3f7d7abd7509e7e9894 Mon Sep 17 00:00:00 2001
From: RayPals <raypals@noreply.codeberg.org>
Date: Mon, 1 Jun 2026 00:54:26 +0200
Subject: [PATCH] Add docs/QUICK_START.md from Claro v1.17.26 zip

---
 docs/QUICK_START.md | 104 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 104 insertions(+)
 create mode 100644 docs/QUICK_START.md

diff --git a/docs/QUICK_START.md b/docs/QUICK_START.md
new file mode 100644
index 0000000..fc77391
--- /dev/null
+++ b/docs/QUICK_START.md
@@ -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.