FÜR SUPPORT, PRODUKT UND TECHNISCHE REDAKTION
Der Hilfe-Artikel sagt 14 Tage. Der Code sagt 30.
Support antwortet nach dem Artikel, der Kunde bekommt eine falsche Auskunft, und niemand hat es gemerkt. FACET verbindet die Erklärung mit der Stelle im Code, aus der sie stammt — ändert sich die Regel, meldet sich der Artikel.
knowledge: prerequisite_knowledge: answer: A refund is possible within 14 days of purchase. common_pitfalls: answer: Counting from delivery instead of from purchase. success_signal: answer: The order shows “refund requested” with the date.
HILFE
Eine Bestellung erstatten lassen
Innerhalb von 14 Tagen nach dem Kauf kannst du eine Erstattung beantragen. Gezählt wird ab dem Kaufdatum, nicht ab der Lieferung. Danach zeigt die Bestellung „Erstattung angefragt“ mit dem Datum.
Quelle: billing/refunds/refund-window · 3 Knowledge-Slots
Illustratives Beispiel · der Artikel ist aus Bausteinen gezeichnet, nicht generiert
UND WENN AUS 14 TAGEN 30 WERDEN?
Die Frist ändert sich. Der Artikel meldet sich von selbst.
Jeder erzeugte Hilfetext weiß, woraus er entstanden ist. Ändert sich die Regel, meldet facet docs check den Artikel als veraltet — bevor ein Kunde die alte Frist liest. Korrigiert wird die Regel, der Text wird neu erzeugt.
knowledge: prerequisite_knowledge: answer: A refund is possible within 14 days of purchase. answer: A refund is possible within 30 days of purchase. common_pitfalls: answer: Counting from delivery instead of from purchase.
$ facet docs checkstale: docs/help/refunds.md (billing/refunds/refund-window) input docs/facets/features/billing/refunds/refund-window.yaml changed since generation 1 artifact(s) checked — 1 need regeneration A changed input does not always mean the article is wrong. Review thediff before regenerating; a refactor that preserves behaviour needs nothing.
Illustratives Beispiel · Zeilenform wie in facet docs check; die Herkunft eines Artefakts hält facet docs record fest
EINE QUELLE, MEHRERE LESER
Eine Antwort. In der Sprache eurer Leser.
Kunde, Support, Vertrieb: Jeder braucht eine andere Erklärung derselben Regel. Agents schreiben sie aus derselben Grundlage, statt für jeden Artikel den Code neu zu lesen. Was noch niemand beantwortet hat, steht in keinem Text.
QUELLEbilling/refunds/refund-windowknowledge
HILFE
Eine Bestellung erstatten lassen
Innerhalb von 14 Tagen nach dem Kauf. Gezählt wird ab dem Kaufdatum.
prerequisite_knowledge · common_pitfalls · success_signal
FAQ
Warum wurde meine Erstattung abgelehnt?
Die 14 Tage zählen ab dem Kauf, nicht ab der Lieferung.
common_pitfalls
EINFÜHRUNG
Erstattungen für neue Support-Kollegen
Was die Frist ist, wofür sie nicht gilt und woran der Kunde den Erfolg erkennt.
prerequisite_knowledge · not_for · success_signal
Illustratives Beispiel · Titel und Auszüge sind erfunden, die Slot-Namen sind die der Spezifikation
WAS FACET HIER NICHT TUT
Die Quelle schreibt sich nicht selbst.
Die Grundlage braucht fachliche Pflege. Fremde Wikis werden nicht automatisch aktuell.