Conventions

General

Hints can be 5-10 lines long and multiple paragraphs. Can contain references to the source material.

Page structure

01--epg-guidance.md (amber box) 02--kpg-principle.md (sky box) 03--...md onwards (other guidance boxes) 04--einleitung.md (markdown block) ... content blocks (markdown, reflection, etc.) 99-*-quality-check.md (slate box) vertical-hint-column.md (always visible on the right side of the page, contains the guidance section)

EPG Guidance

Provide a concise summary of the key concepts and principles of EPG related to the page, detailing the scoring criteria. This is the only place where scoring criteria should be mentioned.

KPG Guidance

Provide a concise summary of the key concepts and principles of KPG related to the page.

Einleitungsabsatz

This is the section where the user describes the goal of the current chapter. Provide a hint accordingly. No footnote is necessary here.

Qualitätsprüfung

The final checklist to ensure that all necessary elements are included and correctly filled out on the page. This should be a comprehensive list that covers all aspects of the page's content and structure, ensuring that it meets the standards for both KPG and EPG. Do not repeat the scoring points here.

Writing style and language guide

When helping the user to write the content blocks, follow these guidelines:

Die 10 wichtigsten Schreibregeln

Ich-Perspektive, aktiv und direkt – Aus der Ich-Perspektive schreiben, kurze aktive Sätze, sofort auf den Punkt kommen.
Kein «Beamtendeutsch» – Keine Passivkonstruktionen («Es wurde festgestellt …»), keine Schachtelsätze, keine aufblähenden Füllwörter («im Rahmen von», «es handelt sich um»).
Kein Nominalstil – Verben statt Substantivierungen: nicht «Verwahrlosung», sondern beschreiben, was konkret passiert ist.
Fakten und Hypothesen sauber trennen – Beobachtungen («Ich beobachtete …»), Vermutungen («Ich vermute …») und gesicherte Fakten immer sprachlich klar unterscheiden.
Alle Akteure benennen – Wer handelt, entscheidet oder urteilt, muss im Text sichtbar sein – sowohl Fachperson als auch Adressatin/Adressat.
Ressourcenorientiert formulieren – Verhalten konkret beschreiben statt kategorisieren («aggressiv», «depressiv»). Veränderungsmöglichkeiten sichtbar machen.
Roter Faden sicherstellen – Kapitel mit kurzer Einleitung beginnen, am Ende zusammenfassen, Überleitungen explizit gestalten.
Fachsprache dosiert einsetzen – Theorien und Fachbegriffe nur dort, wo sie im Kapitel wirklich behandelt werden – nicht als Dekoration.
APA-Zitation konsequent und dicht – Jede fremde Idee mit Kurzverweis (Autor, Jahr, Seite) belegen, direkt beim betreffenden Abschnitt – nicht erst am Kapitelende.
Standarddeutsch (de-CH), keine Helvetismen – Korrekte Orthografie, keine Alltagssprache; KI-Einsatz im separaten Verzeichnis deklarieren.

See the full set of guidelines here: documents/WRITING-STYLE.md

3.0 KiB Raw Blame History Unescape Escape