update
This commit is contained in:
@@ -8,6 +8,7 @@ STIL-REGELN:
|
||||
2. description — was es ist und wozu: MAXIMAL 1–2 Sätze
|
||||
3. examples — KURZ und SIMPEL: wenige Zeilen Code, Minimalbeispiel, keine Realwelt-Komplexität. Ein Beispiel pro relevanter Variante, geordnet vom Üblichen zum Speziellen. Als Codeblock mit Sprachangabe (```sprache), nie als Inline-Code. Jedes Beispiel beginnt mit einem kurzen Kommentar in der Code-Syntax (z. B. `<!-- Einzelner Absatz -->`), der die Variante benennt.
|
||||
4. hints — jeder Hinweis muss WICHTIG oder NÜTZLICH sein: Stolperfalle, Merksatz oder Best Practice mit echtem Praxiswert. Selbstverständliches, Nischenwissen und Redundantes zum Element entfernen. Telegrammstil: nur die Kernaussage, Füllverben und Herleitungen streichen.
|
||||
aufgabe — EINE konkrete, in Minuten lösbare Übungsaufgabe, die das Verständnis prüft. loesung — knappe, nachvollziehbare Musterlösung dazu. Beide: Code als Codeblock mit Sprachangabe.
|
||||
Vorher: "Browser fügen standardmäßig vertikalen Abstand vor und nach `<p>` ein — anpassbar mit `margin`."
|
||||
Nachher: "Browser-Abstand um `<p>` per `margin` anpassbar."
|
||||
5. Umfang: SO LANG WIE NÖTIG und SO KURZ WIE MÖGLICH. Jedes Wort muss seinen Platz verdienen — Füllwörter, Nebensätze ohne Informationswert und Selbstverständliches streichen. Aber: Kürze nie auf Kosten der Verständlichkeit oder Korrektheit.
|
||||
@@ -17,8 +18,8 @@ STIL-REGELN:
|
||||
Schlage für jeden Stil-Verstoß GENAU EINE Änderung vor:
|
||||
- text: kurz, was und warum (max. 12 Wörter, reiner Text)
|
||||
- action: "entfernen" | "anpassen" | "hinzufuegen"
|
||||
- target: "title" | "description" | "examples" | "hints"
|
||||
- index: 0-basierte Position im AKTUELLEN examples- bzw. hints-Array (bei title/description: null; bei hinzufuegen: null)
|
||||
- target: "title" | "description" | "examples" | "hints" | "aufgabe" | "loesung"
|
||||
- index: 0-basierte Position im AKTUELLEN examples- bzw. hints-Array (bei title/description/aufgabe/loesung: null; bei hinzufuegen: null)
|
||||
- content: der neue/vollständige Inhalt (bei entfernen: leer)
|
||||
|
||||
"entfernen" nur für examples/hints. "hinzufuegen" sparsam — nur wenn eine Stil-Regel es verlangt (z. B. fehlender Varianten-Kommentar gehört zu "anpassen", nicht "hinzufuegen"). Erfüllt etwas die Regeln schon: NICHT anfassen.
|
||||
|
||||
Reference in New Issue
Block a user