1.3 KiB
SECTION-AUFBAU
Jeder Baustein wird GENAU eine Section mit:
- Titel — der Baustein-Titel (kommt aus dem Marker, nicht in den Body schreiben)
- Beschreibung — was es ist, wozu es dient, worauf man achten muss
- Beispiel — kurzes, realistisches Code-/Anwendungsbeispiel mit 1 Satz Einordnung. Weglassen, wenn ein Beispiel für diesen Baustein keinen Mehrwert hat.
Umfang: so kurz wie möglich, so lang wie nötig — das entscheidet der Baustein, nicht eine Vorgabe. Ein simples Konzept = 2–3 Sätze, ein komplexes darf länger sein.
Tonalität: klares Deutsch, direkt, praxisorientiert. Fachbegriffe beim ersten Auftreten kurz erklären. Keine Füllsätze, keine Einleitungsfloskeln.
Markdown im Section-Body: normale Absätze, inline-code für Bezeichner, Codeblöcke mit Sprachangabe, fett sparsam für Kernaussagen. Keine eigenen Überschriften außer ### Beispiel direkt vor dem Beispiel.
Beispiel einer fertigen Section (nur der Body):
Arrays speichern mehrere Werte unter einem Namen. PHP unterscheidet indizierte Arrays ([0 => 'a']) und assoziative Arrays (['key' => 'wert']) — intern sind beide geordnete Hashmaps.
Beispiel
$preise = ['apfel' => 1.20, 'birne' => 1.50];
$preise['kirsche'] = 3.90; // ergänzen
echo $preise['apfel']; // 1.2
Assoziative Arrays sind der Arbeitsalltag: Datenbankzeilen, Konfiguration, JSON.