Ein Layout kann noch so sauber gestaltet sein: Wenn unklar bleibt, warum etwas so gebaut ist, entstehen Rückfragen, Verzögerungen und unnötige Varianten. Genau hier helfen Design-Annotationen. Gemeint sind kurze Hinweise direkt am Screen, die Entscheidungen erklären, Regeln festhalten oder Umsetzungsdetails markieren. Das ist kein Extra-Aufwand „für später“, sondern eine einfache Methode, um Feedback zu präzisieren und die Übergabe an Entwicklung oder Content-Teams zu stabilisieren.
Der entscheidende Punkt: Kommentare in Figma sind oft Gesprächsverlauf. Annotationen sind dagegen Dokumentation in klein. Sie bleiben am richtigen Ort, sind für alle sichtbar und lassen sich systematisch aufbauen.
Wann Annotationen sinnvoller sind als normale Kommentare
Kommentare eignen sich gut für offene Diskussionen („Option A oder B?“). Sobald aber etwas als Regel gelten soll, sind Annotationen die bessere Wahl. Sie reduzieren Missverständnisse, weil sie unabhängig vom Chat-Kontext verständlich bleiben.
Typische Situationen aus dem Alltag
- Ein Button-Text ist bewusst kurz, weil sonst in kleinen Breakpoints (Bildschirmbreiten) das Layout bricht.
- Ein Bildausschnitt ist gewollt, damit das Motiv im Header nicht „abgeschnitten“ wirkt.
- Ein Formularfeld hat bestimmte Fehlermeldungen, weil die Validierung (Prüfung) im Backend genau diese Fälle liefert.
- Ein Element sieht „zu groß“ aus, ist aber absichtlich so gewählt, weil es der primäre Klickpunkt ist.
In solchen Fällen spart eine Annotation mehrere Rückfragen. Für Formular-Details lohnt sich zusätzlich ein Blick in UI-Formulare gestalten – Felder, Fehlertexte und Flow, weil dort viele typische Stolpersteine bereits als Muster beschrieben sind.
Ein einfaches System: Welche Infos in eine Annotation gehören
Damit Hinweise nicht ausufern, hilft ein gleiches Format. Gute Annotationen sind kurz, aber vollständig. Bewährt hat sich ein Baukasten aus vier Teilen:
- Intent: Was soll erreicht werden? (z. B. „Blick auf Preis lenken“)
- Regel: Welche UI-Regel gilt? (z. B. „Primärer CTA immer rechts“)
- Ausnahme: Wann gilt die Regel nicht? (z. B. „auf Mobile CTA unter Text“)
- Umsetzung: Was muss technisch/inhaltlich passieren? (z. B. „Text aus CMS-Feld X“)
Beispiel: Eine Annotation, die wirklich hilft
Statt: „Header bitte größer“
Besser: „Intent: Hauptbotschaft zuerst. Regel: Headline bleibt maximal zweizeilig, sonst rutscht der CTA unter die Falz (sichtbarer Bereich ohne Scroll). Umsetzung: Headline-Text im CMS auf 55–70 Zeichen begrenzen; längere Texte werden gekürzt.“
So wird aus einer Geschmacksaussage eine nachvollziehbare Entscheidung. Für die Priorisierung im sichtbaren Startbereich passt auch Above the Fold im Webdesign – Inhalte priorisieren als ergänzender Kontext.
Layout und Lesbarkeit: Annotationen, die nicht stören
Annotationen sollen Informationen geben, nicht das Design überdecken. Der Trick ist, sie wie ein eigenes UI-Layer zu behandeln: konsistent, zurückhaltend und leicht ausblendbar.
Praktische Regeln für die Platzierung
- Hinweise am Rand platzieren und mit kurzen Linien/Arrows (Pfeilen) zuordnen, statt über die UI zu schreiben.
- Pro Screen lieber mehrere kleine Hinweise als einen langen Absatz.
- Nummerierung nutzen, wenn sich mehrere Hinweise aufeinander beziehen (z. B. 1. Inhalt, 2. Verhalten, 3. Edge Case).
- Einheitliche Wortwahl: immer „Soll“, „Muss“, „Darf nicht“ für Verbindlichkeit.
Begriffe kurz erklärt
Ein Edge Case ist ein Sonderfall, der selten vorkommt, aber trotzdem bedacht werden muss (z. B. extrem lange Namen, fehlendes Bild, kein Rabattpreis). Wer diese Fälle früh markiert, verhindert Bugs und „Design drift“ (wenn die Umsetzung schleichend vom Design abweicht).
Figma-Workflow: Annotationen als eigenes „Deliverable“
Damit Annotationen nicht im Durcheinander enden, sollten sie einen festen Platz im File bekommen. Gute Praxis ist: ein dedizierter Flow für „Design + Notes“ und eine klare Trennung zu explorativen Screens.
So geht’s in der Praxis (kurz und umsetzbar)
- Eine Seite (Page) im Figma-File nur für „Ready for Review“ anlegen.
- Pro Screen eine kleine Notes-Zone am Rand reservieren.
- Annotationen als eigene Komponente anlegen (z. B. Label + Linie), damit alles gleich aussieht.
- Einheitliches Präfix in Texten nutzen, z. B. „Intent:“, „Rule:“, „Dev:“.
- Offene Fragen nicht als Annotation, sondern als Kommentar führen (damit klar bleibt, was entschieden ist).
Wenn ein Team oft über Abstände diskutiert, ist es sinnvoll, diese Regeln einmal sauber zu fixieren und dann in Annotationen nur noch darauf zu verweisen. Dazu passt Design-Spacing im Webdesign – Abstände mit System planen.
Welche Arten von Annotationen wirklich gebraucht werden
Nicht jede Information ist gleich wichtig. In Webdesign und UI/UX haben sich fünf Annotationstypen bewährt. Sie decken die meisten Fragen aus Review, Content und Entwicklung ab.
1) Verhalten und Zustände
Alles, was sich verändert, braucht einen Hinweis: Hover (wenn man mit der Maus darüberfährt), Active (gedrückt/aktiv), Disabled (deaktiviert), Loading (lädt). Gerade bei Komponenten spart das viel Nacharbeit. Wichtig ist: nicht „fühlt sich gut an“ beschreiben, sondern den konkreten Zustand.
Hier hilft eine Verknüpfung zu UI-States designen – Hover, Active, Disabled sauber lösen, wenn die Zustände im Team noch nicht standardisiert sind.
2) Inhalte und Copy-Regeln
Annotationen sollten klarstellen, welche Texte dynamisch (aus dem System) kommen und welche statisch sind. Außerdem: maximale Textlängen, erlaubte Zeilenumbrüche, Pflichtfelder, und wie mit leeren Werten umzugehen ist („Wenn kein Preis verfügbar: ‚Preis auf Anfrage‘ anzeigen“).
3) Responsive Verhalten
Viele Reviews scheitern daran, dass nur Desktop betrachtet wird. Annotationen können festhalten, wie Elemente umbrechen, stapeln oder priorisiert werden. Das ist besonders wichtig bei Cards, Listen und komplexen Headern.
4) Interaktion und Fokusführung
Wenn ein Element Aufmerksamkeit bekommen soll, reicht „macht das auffälliger“ nicht. Eine gute Annotation benennt den Grund (z. B. „Primäre Aktion“) und die konkrete Stellschraube (z. B. „Button-Style primär; sekundäre Links als Textlink“). Hier zahlt sich saubere Design-Hierarchie aus, weil Entscheidungen nachvollziehbar bleiben.
5) Technische Hinweise (ohne Entwicklersprache)
Technik muss nicht wie Code klingen. Es reicht, klar zu sagen, was variabel ist (z. B. „Liste kann 0–12 Elemente haben“), welche Reihenfolge gilt und welche Abhängigkeiten bestehen („Badge nur zeigen, wenn Status = Neu“).
Mini-Entscheidungshilfe für Reviews (als Baum)
Wenn unklar ist, ob etwas als Annotation dokumentiert werden sollte, hilft diese einfache Logik:
- Ist es eine Geschmacksfrage?
- Ja: als Kommentar diskutieren und Entscheidung später als Annotation festhalten.
- Nein: weiter prüfen.
- Kann es bei Umsetzung oder Content zu Rückfragen führen?
- Ja: annotieren (kurz, konkret).
- Nein: weiter prüfen.
- Gilt es als Regel für mehrere Screens/Komponenten?
- Ja: Regel einmal zentral dokumentieren und in Screens nur referenzieren.
- Nein: als lokale Annotation am Screen belassen.
Vergleich: Annotationen vs. Prototyp vs. Spezifikation
| Format | Stark, wenn … | Grenze |
|---|---|---|
| Annotation im Screen | Entscheidungen, Regeln und Sonderfälle schnell sichtbar sein sollen | Zu viele Hinweise können den Screen überladen |
| Prototyp (klickbar) | Flows (Abläufe) und Interaktion gezeigt werden müssen | Erklärt selten „warum“; Details gehen unter |
| Spezifikation/Doc | Viele Regeln, Zustände, Content-Logik zentral gesammelt werden | Wird im Alltag eher übersehen als ein Hinweis direkt am UI |
Im Idealfall ergänzen sich die Formate: Prototyp für den Ablauf, Annotationen für Entscheidungen, und ein kurzes Dokument für wiederkehrende Regeln. Wer regelmäßig an Übergaben arbeitet, findet zusätzliche Struktur-Ideen in Design-Übergaben in Figma – Specs, Assets, Kommentare sauber.
Textbausteine, die in Teams funktionieren
Damit Hinweise nicht jedes Mal neu formuliert werden müssen, helfen wiederkehrende Satzmuster. Sie sind klar, neutral und ohne Fachjargon:
- UI-Spezifikation: „Wenn Zustand X, dann zeige Y. Wenn nicht, zeige Z.“
- „Diese Komponente ist wiederverwendbar für: …“
- „Content-Regel: Max. … Zeichen, sonst …“
- „Sonderfall: Wenn … fehlt, dann … anzeigen.“
- „Nicht ändern, weil: … (Auswirkung: …)“
Wichtig ist, dass diese Bausteine nicht als „Befehlston“ wirken. Klarheit entsteht durch Begründung und Konsequenz: Was passiert, wenn man es anders macht?
Häufige Fehler, die Annotationen entwerten
Zu vage Formulierungen
„Mehr Luft“, „moderner“, „cleaner“: Das sind Startpunkte für Gespräche, aber keine umsetzbaren Hinweise. Besser ist, die Stellschraube zu nennen: Abstand, Schriftgröße, Kontrast, Reihenfolge, Verhalten.
Annotationen ohne Gültigkeit
Wenn unklar bleibt, ob etwas nur Wunsch oder verbindliche Regel ist, entstehen wieder Diskussionen. Ein kleines Wording-System hilft: „Muss“ für Pflicht, „Soll“ für Standard, „Kann“ für optional.
Wichtige Regeln nur im Kommentarverlauf
Kommentare verschwinden im Strom. Was entschieden ist, gehört als kurze Annotation an den Screen oder in eine zentrale Regelsammlung. Das stärkt die Nachvollziehbarkeit und spart Zeit bei späteren Iterationen.
Wie Teams damit schneller werden (ohne extra Meetings)
Design-Annotationen sind besonders effektiv, wenn sie nicht nur „Design erklären“, sondern Entscheidungen festhalten, die sonst in Meetings wiederholt werden. So wird Review-Zeit genutzt, um echte Fragen zu klären, statt bereits entschiedene Details neu zu verhandeln.
Ein guter Start ist, ein kleines Set an Standard-Annotationen für ein Projekt zu definieren: Zustände, Responsive Regeln, Content-Längen, Sonderfälle. Danach wird nur noch ergänzt. Genau das sorgt für stabile Qualität, auch wenn neue Personen ins Projekt kommen.
Kurze kompakte Prüfliste vor dem Teilen
- Ist pro Screen klar, was der wichtigste Klickpunkt ist?
- Gibt es Hinweise zu Zuständen (Hover/Loading/Fehler), wenn relevant?
- Sind Textlängen oder Content-Quellen markiert?
- Ist Responsive Verhalten zumindest für kritische Bereiche beschrieben?
- Sind Sonderfälle benannt, die sonst zu Bugs führen?
Wer diese Punkte konsequent abdeckt, bekommt weniger Rückfragen, stabilere Umsetzungen und schnellere Freigaben.

