Microcopy-Leitfaden

Gilt für Deutsch und Englisch. Quelle der Texte in der App: apps/web/lib/messages/{de,en}.json. Beide Dateien haben immer dieselben Schlüssel (Test).

Haltung

Ruhig, warm, verlässlich, wie ein gut organisiertes Klassenzimmer-Brett. Nicht verspielt-kindisch, nicht steril-behördlich. Drei Werte:

Klar: Wichtiges zuerst. Der Button heißt „Zusagen“, nicht „Absenden“.
Warm: Wir reden mit Menschen, nicht mit Fällen. „Das hat nicht geklappt. Versuch es bitte noch einmal.“
Sparsam: Wir fragen und zeigen nur, was nötig ist. Kinder erscheinen nur als „Hanno C.“

Anrede

Wer	Anrede	Beispiel
Eltern	du	„Wir haben einen Link an deine Adresse geschickt.“
Verwaltungsrollen (Mandanten-Admin, Finanzverwalter)	du	„Als Mandanten-Admin siehst du Klassen und Nutzer.“
Lehrkräfte	Sie	„Bitte prüfen Sie Ihr Postfach.“
Dokumente von der Lehrkraft an Eltern (Elternbrief, Protokoll)	Sie	„Wir laden Sie herzlich zum Elternabend ein.“

„du“, „dein“, „dir“ werden mitten im Satz kleingeschrieben, am Satzanfang wie jedes Wort groß. Englisch kennt keinen Unterschied („you“). Nie mischen: Eine Seite spricht eine Person nur auf eine Art an.

Satzbau

Kurze Sätze, etwa Niveau B1, aktive Verben, ein Gedanke pro Satz.
Ein Verb pro Button, konkret: „Link anfordern“, „Buchen“, „Einwilligung widerrufen“. Nie „OK“, „Weiter“, „Absenden“, wenn es etwas Genaueres gibt.
Überschriften nennen das Thema, nicht die Funktion: „Meine Kinder“, „Klassenkasse“.
Zahlen als Ziffern: „3 Termine“. Deutsch mit geschütztem Leerzeichen vor Einheiten und Euro: 50,00 €.
Auslassungspunkte als „…“, Anführungszeichen „so“ (deutsch) bzw. “so” (englisch), kein gerades ".

Fehlermeldungen

Aufbau: Was ist passiert. Was kann man tun. Keine Schuld, keine Codes.

Gut: „Der Link war zu alt oder wurde schon benutzt. Fordere einen neuen an.“
Schlecht: „Fehler 401: Token invalid.“
Am Feld: nennt das Beispiel („Bitte nutze Ziffern, zum Beispiel 50,00.“).
Serverfehler: „Bei uns ist etwas schiefgelaufen. Versuch es in ein paar Minuten noch einmal.“ Nichts versprechen, was nicht sicher ist (z. B. „Deine Eingaben sind nicht verloren“).

Leere Zustände

Sagen, was hier erscheinen wird und was man tun kann.

Situation	Eltern (du)	Lehrkräfte (Sie)
Link verschickt	„Wir haben einen Link an deine Adresse geschickt. Öffne die E-Mail und tippe auf den Link.“	„Wir haben Ihnen einen Link geschickt. Bitte prüfen Sie Ihr Postfach.“
Link abgelaufen	„Der Link ist abgelaufen. Fordere einen neuen an.“	„Der Link ist abgelaufen. Bitte fordern Sie einen neuen an.“
Keine Nachrichten	„Noch keine Nachrichten.“	„Noch keine Nachrichten. Sie können die erste schreiben.“
Keine Klasse	„Du hast aktuell keinen Zugriff auf eine Klasse. Wende dich an die Klassenleitung oder die Schulverwaltung.“	„Ihnen ist noch keine Klasse zugeordnet. Bitte wenden Sie sich an die Schulverwaltung.“

Datenschutz in Texten

Kinder nur mit Vorname und abgekürztem Nachnamen, in Beispielen und Echtdaten. Keine Fotos, keine weiteren Angaben ohne Einwilligung.
Hinweise kurz und konkret („Ohne deine Einwilligung wird nichts über dein Kind gespeichert, was über Vorname und abgekürzten Nachnamen hinausgeht.“).
Rechtstexte (Impressum, Datenschutzerklärung) schreibt kein Designer: Platzhalter-Links sind als solche markiert.

Zustände und Rückmeldung

Laden: „Speichert…“ (mit Auslassungspunkten).
Erfolg: konkret („Foto-Einverständnis widerrufen.“), nicht „Erfolgreich“.
Status immer mit Text, Icon oder Vorzeichen, nie nur mit Farbe. Einnahme „+50,00 €“, Ausgabe „−120,00 €“ (echtes Minuszeichen).
„Neu“ ist das einzige gelb Markierte.

Englisch

Gleiche Haltung, gleiche Kürze. „you“ für alle. Datum „15 Oct 2026“, Uhrzeit „7:00 pm“, Betrag „€1,284.50“. Keine wörtlichen Übersetzungen, die Behördendeutsch spiegeln.

Prüfen vor dem Einchecken

Beide Sprachdateien angepasst? (npm test -w @klasu/web)
Anrede passt zur Rolle der Leserin oder des Lesers?
Sagt der Text, was passiert ist und was als Nächstes geht?
Keine echten Namen oder Daten von Kindern?