Content Freshness, Teil 1: Die Kennzahl, die dein Team nicht im Blick hat

Es gibt einen Moment, den jedes Entwicklungsteam schon einmal erlebt hat. Jemand findet ein Dokument im internen Wiki, folgt den Anweisungen und dann geht etwas kaputt. Sie schicken eine Nachricht an den Channel: "Stimmt das noch?" Niemand weiß es. Die Person, die es geschrieben hat, ist vor acht Monaten gegangen. Im Dokument steht, dass es zuletzt 2024 bearbeitet wurde.

Das ist das Problem mit der Aktualität. Und es wird immer schlimmer.

Der alte Vertrag bricht zusammen

Lange Zeit hatten Dokumentationen einen impliziten Vertrag: Jemand schreibt sie, alle vertrauen darauf, und gelegentlich aktualisiert sie jemand. Vielleicht. Dieser Vertrag funktionierte gerade noch, als die Dokumentation nur von Leuten konsumiert wurde, die sich ein Urteil bilden konnten. Wenn eine Einrichtungsanleitung nicht ganz stimmte, passte ein erfahrener Ingenieur sie einfach im Handumdrehen an.

Aber diese Welt ist vorbei. Heute wird deine Dokumentation nicht nur von Menschen gelesen. Sie wird von KI-Tools, internen Chatbots, Onboarding-Automatisierung und Suchsystemen genutzt, die jedes Wort als gleichwertige Wahrheit behandeln. Ein KI-Assistent blinzelt nicht auf eine Dokumentation und denkt: "Das sieht ein bisschen veraltet aus", sondern er liest den Text, verarbeitet ihn als Tatsache und serviert ihn mit vollem Vertrauen.

Veraltete Dokumente plus KI gleich vertrauenswürdige falsche Antworten in großem Umfang.

Was Frische wirklich bedeutet

Frische bedeutet nicht nur "wann wurde das zuletzt bearbeitet". Eine Dokumentation kann gestern bearbeitet worden sein und trotzdem auf eine veraltete API verweisen. Echte Frische ist ein zusammengesetztes Signal:

• Review-Status. Hat jemand explizit bestätigt, dass das Dokument noch aktuell ist?
• Link-Gesundheit. Werden die URLs in der Dokumentation noch aufgelöst?
• Leserschaft. Nutzt das überhaupt noch jemand, oder wurde es aufgegeben?
• Kontextabweichung. Haben sich verwandte Dokumente geändert, während dieses Dokument gleich geblieben ist?
• Übersetzungsabgleich. Wenn das Dokument in fünf Sprachen existiert, sind dann alle auf dem neuesten Stand?
• Gemeinschaftssignale. Haben Leser dieses Dokument als veraltet gekennzeichnet?

Jede dieser Angaben sagt dir etwas anderes. Zusammen ergeben sie einen Trust Score: eine einzelne Zahl, die angibt, wie viel Vertrauen du in einen Inhalt setzen solltest.

Warum das gerade jetzt wichtig ist.

Drei Dinge sind zusammengekommen, um die Aktualität von Inhalten dringend erforderlich zu machen:

1. KI verbraucht deine Wissensbasis

Ganz gleich, ob du ein internes RAG-System einsetzt, Copilot in deiner IDE verwendest oder einen KI-Assistenten mit der Beantwortung von Fragen aus deinen Dokumenten beauftragst: Die Qualität des Quellmaterials bestimmt direkt die Qualität der Ausgabe. Garbage in, garbage out war noch nie so wörtlich zu nehmen.

Wenn ein Entwickler deinen KI-Assistenten fragt: "Wie kann ich in Staging deployen?" und er antwortet mit einem zwei Jahre alten Runbook, das auf eine Infrastruktur verweist, die du inzwischen migriert hast, dann ist das nicht nur eine falsche Antwort. Es ist das verlorene Vertrauen in das gesamte System.

2. Teams sind verteilter denn je

Ein Team in Berlin, ein anderes in São Paulo, ein drittes in Tokio. Alle lesen die gleiche Dokumentation, oft in verschiedenen Sprachen. Wenn der englische Quelltext veraltet, werden auch alle darauf aufbauenden Übersetzungen veraltet, aber niemand merkt es, weil die Übersetzungen, wenn überhaupt, separat gepflegt werden.

3. Der Druck durch Compliance und Audits steigt

Regulierte Branchen beginnen zu fragen: "Kannst du beweisen, dass diese Dokumentation zu dem Zeitpunkt, als sie referenziert wurde, aktuell war?" Wenn deine Antwort lautet: "Na ja, irgendjemand hat sie wahrscheinlich überprüft", wird das nicht ausreichen.

So sieht ein Freshness-First-Ansatz aus

Der Grundgedanke ist einfach: Jedes Dokument muss sich kontinuierlich das Recht verdienen, vertrauenswürdig zu sein.

Das bedeutet:

1. Vorgeschriebene Überprüfungsdaten. Jedes Dokument bekommt ein Verfallsdatum, wenn es erstellt wird. Keine Ausnahmen. Wenn das Datum erreicht ist, wird der Eigentümer benachrichtigt und das Dokument wird markiert, bis es jemand explizit wieder freigibt.

2. Automatische Gesundheitsüberwachung Im Hintergrund prüft das System kontinuierlich auf defekte Links, Lesertrends und kontextuelle Veränderungen. Diese Signale fließen in eine Live-Bewertung ein, die aktualisiert wird, ohne dass jemand etwas tun muss.

3. Die Aktualität wirkt sich auf die Sichtbarkeit aus. Dies ist der Schlüsselmechanismus. Ein Dokument mit hoher Punktzahl taucht in den Suchergebnissen ganz oben auf und kann als Quelle für KI-Antworten verwendet werden. Ein Dokument mit einer niedrigen Punktzahl fällt in der Rangliste zurück. Fällt es unter einen Schwellenwert, wird es ganz von den KI-Antworten ausgeschlossen.

4. Transparenz. Jeder kann sehen, warum ein Dokument so bewertet wurde, wie es bewertet wurde. Kaputte Links, überfällige Überprüfungen, geringe Leserschaft - die Signale sind sichtbar und nicht in einem Backend-Bericht versteckt, den niemand liest.

Die Kosten des Nichtstuns

So sieht es aus, wenn du die Aktualität nicht verfolgst:

• Neue Mitarbeiter folgen veralteten Onboarding-Dokumenten und verbringen ihre erste Woche verwirrt
• KI-Tools liefern falsche Antworten und niemand versteht, warum.
• Compliance-Dokumente werden stillschweigend veraltet und stellen ein Audit-Risiko dar.
• Übersetzungen geraten aus dem Gleichgewicht und Teams in verschiedenen Regionen arbeiten mit unterschiedlichen Versionen der Realität
• Ingenieure vertrauen dem Wiki nicht mehr und greifen auf Slack-Nachrichten zurück, wodurch ein eigenes Wissenssilo entsteht

Die Kosten, die durch veraltete Dokumentation entstehen, sind enorm, aber sie sind unsichtbar, bis etwas kaputt geht.

Ein praktischer Ansatzpunkt

Du musst nicht alles auf einmal überarbeiten. Fang mit diesen Punkten an:

1. Überprüfe deine 20 meistgelesenen Dokumente. Wann wurden sie zuletzt überprüft? Sind die Links noch gültig? Ist der Inhalt noch korrekt?

2. Setz dir Überprüfungsdaten. Auch wenn du sonst nichts tust, schafft die Angabe eines "Überprüfungsdatums" auf jedem Dokument Verantwortlichkeit.

3. Verfolge, was deine KI-Tools beschaffen. Wenn du einen internen KI-Assistenten hast, schau dir an, welche Dokumente er abruft. Sind diese Dokumente aktuell?

4. Mach die Aktualität sichtbar. Platziere den Wert dort, wo er sichtbar ist: neben dem Titel des Dokuments, in den Suchergebnissen, in der Seitenleiste. Sichtbarkeit schafft Druck, die Aktualität zu erhalten.

Dokumentationsfrische ist kein Feature. Es ist ein grundlegender Wandel in der Art und Weise, wie wir über organisatorisches Wissen denken. In einer Welt, in der KI-Tools deine Dokumente in großem Umfang verbrauchen und weiterverteilen, stellt sich nicht mehr die Frage, ob du es dir leisten kannst, auf Aktualität zu achten. Es geht darum, ob du es dir leisten kannst, es nicht zu tun.

Jedes Dokument sollte beweisen müssen, dass es noch vertrauenswürdig ist. Nicht nur einmal. Kontinuierlich.

Das ist es, was wir bei Rasepi aufbauen. Eine Plattform, bei der Frische kein nachträglicher Gedanke ist. Sie ist das Fundament, auf dem alles andere aufgebaut ist. Review Enforcement, Live Health Scoring, eine nach Frische gewichtete Suche und KI-Antworten, die nur Quellen verwenden, denen du vertrauen kannst.

So funktioniert's →

Dies ist Teil 1 einer zweiteiligen Serie. In Teil 2: Jenseits des Verfallsdatums untersuchen wir, wie die kontinuierliche Frischeüberwachung die Lücken füllt, die das Verfallsdatum offen lässt.