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