Entwicklungsteams
Das Wiki, die Datenblätter und die Wahrheit
Ein Team der Industrieelektronik richtete Cogeto auf alles: das Wiki, dem niemand traut, eine Familie von vierzig fast identischen Datenblättern und die Entscheidungsthreads. Jetzt antwortet das Korpus mit Quellenangaben, und die Drift hat Namen.
Die Ausgangslage
Dokumentationsdrift, ungemessen
Das Wiki, dem niemand traut
Drei Leute haben es seit 2022 bearbeitet. Alle vermuten, dass es irgendwo falsch ist; niemand weiß, wo, also fragt jeder lieber wieder einen Kollegen.
Vierzig Datenblätter, gemeinsame Textbausteine
Fast identische Varianten, die sich in Zahlen unterscheiden, die niemand auswendig nennen kann. Copy-and-paste hält die Textbausteine konsistent und die Unterschiede unsichtbar.
Einarbeitung durch Herumfragen
Entscheidungen leben in Threads und Köpfen. Der erste Monat eines neuen Ingenieurs vergeht damit herauszufinden, welchem Dokument zu misstrauen ist.
Der Lauf
Der Lauf
Ein Massenimport: der Wiki-Export, die Datenblattfamilie, Designnotizen und die archivierten Entscheidungsthreads.
- 1486 Dokumente in einem Vorgang importiert
- 2Datenblätter je Variante verankert, gemeinsame Textbausteine bleiben getrennt
- 3Wiki-Seiten und Threads als Quellen mit Datum gelesen
- 4Verifikation gegen Quellsätze vor dem Speichern
- 5Nächtlicher Abgleich, Variante gegen Variante, Wiki gegen Datenblatt
Die Befunde
Die Befunde
Drei der dreiunddreißig, so wie das Produkt sie meldet.
Das Wiki gegen das Datenblatt: die Drift, die alle vermuteten, beim Namen genannt.
Variante gegen Variante: Die Verankerung hält vierzig Datenblätter getrennt, ein echter Unterschied ist also ein Befund, kein Rauschen.
Der signierte Bericht, den das Team mit dem Quartalsreview ablegt.
Dann fragen Sie.
Welche Datenblätter zeigen noch den alten Ruhestrom? Zwei Varianten führen noch 120 Mikroampere: K-241 r2 und K-244 r1. Der aktuelle Wert ist 85 Mikroampere seit r3. Stands on: K-241 r2, K-244 r1, K-240 r3.
Ist das Gehäuse IP54 oder IP65? IP65. Konflikt: Die Wiki-Hardware-Seite sagt noch IP54, markiert und verknüpft. Stands on: Datenblatt r7, Wiki-Seite.
Was es für Sie bedeutet
Was es für Sie bedeutet
Eine Wissensbasis, die sich selbst belegt
Jede Antwort zitiert Satz und Dokument, oder sagt, dass das Korpus schweigt. Vertrauen hört auf, ein Gefühl zu sein.
Drift am Tag ihres Entstehens gefunden
Eine Wiki-Änderung, die einem Datenblatt widerspricht, ist ein Befund am selben Tag, keine Legende, die sich ein Jahr lang verbreitet.
Einarbeitung aus dem Korpus
Neue Ingenieure fragen das Korpus und bekommen Quellenangaben, statt einen Monat zu lernen, welchen Dokumenten zu misstrauen ist.
Varianten bleiben ehrlich
Vierzig fast identische Datenblätter bleiben je Variante getrennt, der Vertriebsingenieur, der ein Modell anbietet, bekommt also nie die Zahlen eines anderen.
Betreiben Sie es dort, wo Ihr Material liegt
- In der EU gehostet: Ihre Single-Tenant-Instanz, für Sie betrieben.
- Ihre Cloud: deployt in Ihrer eigenen Infrastruktur.
- Vollständig offline: lokale Modelle, keine ausgehende Konnektivität, keine Telemetrie.
Erste Fragen
Unsere Dokumentation ist ehrlich gesagt ein Durcheinander. Ist das ein Problem?
Es ist der Punkt. Je unordentlicher das Korpus, desto wichtiger sind Verifikationsschranke und Unterdrückungsprotokoll: Was sich nicht verifizieren lässt, wird protokolliert, nicht geglaubt.
Wer behebt die Befunde?
Sie, mit beiden Sätzen vor sich. Befunde erscheinen an der Quelle, in Antworten und im Bericht; es gibt keine Warteschlange zu hüten.
Steht das Wiki über dem Datenblatt oder umgekehrt?
Keins von beiden. Ein Konflikt zeigt beide Seiten mit Datum und Revision. Ein Mensch entscheidet; Ihre Bestätigung steht danach über dem Urteil der Maschine.
Weitere Fallstudien
Starten Sie ein Pilotprojekt auf Ihren Dokumenten.
Schicken Sie uns den Wiki-Export und den Datenblattordner; wir liefern den signierten Befundbericht.