start tutorial

README.md

@@ -0,0 +1,33 @@
+# Rust on Robots - Workshop (Didacta Ed.)
+
+Rust ist schnell, modern und hilft dabei, typische Embedded-Fehler früh zu vermeiden – genau das, was man auf Robotern braucht.
+In diesem Workshop gebe ich eine kurze, praxisnahe Einführung in Rust und wir steigen dann direkt in gemeinsame Übungen ein: selbst Rust schreiben, kleine Aufgaben lösen und anschließend Rust auf einem STM32 Bluepill flashen und testen.
+Ideal für RoboCup-Interessierte aus der außerschulischen bzw. beruflichen Bildung, die schon einmal programmiert haben und Rust als Werkzeug für robuste Robotik ausprobieren wollen.
+
+## Workshop Layout
+
+Dieses Repository ist als "Rust by Example"-ähnlicher Lernpfad aufgebaut:
+
+- `tutorial/00-setup-live` bis `tutorial/08-final-combined`
+- Jeder Schritt hat:
+  - `task/` (Aufgabe mit TODOs)
+  - `solution/` (Referenzlösung)
+- Teilnehmer arbeiten nur in `task/`.
+
+## Quick Start
+
+1. Host vorbereiten:
+   - `bash scripts/setup-live.sh`
+2. Host prüfen:
+   - `bash scripts/verify-host.sh`
+3. Probe prüfen:
+   - `bash scripts/verify-probe.sh`
+4. Schritt ausführen:
+   - `bash scripts/run-step.sh 01 task`
+
+## Core Files
+
+- [WORKSHOP.md](/home/wieerwill/Dokumente/GitHub/didkata-rust-on-robots/WORKSHOP.md)
+- [HARDWARE.md](/home/wieerwill/Dokumente/GitHub/didkata-rust-on-robots/HARDWARE.md)
+- [TROUBLESHOOTING.md](/home/wieerwill/Dokumente/GitHub/didkata-rust-on-robots/TROUBLESHOOTING.md)
+- [references/source-map.md](/home/wieerwill/Dokumente/GitHub/didkata-rust-on-robots/references/source-map.md)