#Dokumentation

Ein Drucker, den man per Adresse einrichtet, braucht auch eine fest vergebene Adresse. Unser HP Officejet Pro 8620 hängt per Funk im Netz und holt sich seine Nummer immer wieder neu vom Server, ohne feste Reservierung. Solange sie zufällig gleich bleibt, druckt alles; springt sie einmal, melden alle Rechner den Drucker als offline, obwohl er eingeschaltet danebensteht. Er hat jetzt eine feste Reservierung und ein Kabel dazu. Wer eine Adresse aufschreibt, muss dafür sorgen, dass sie sich nicht ändert.

Ein Gerät im Netz, das niemand zuordnen kann, muss identifiziert werden, nicht geduldet. Beim Durchsehen unseres Werkstattnetzes fand ich einen Teilnehmer ohne sprechenden Namen, ein eingebettetes Funkmodul, das im Sekundentakt eine Zieladresse anruft, die es bei uns gar nicht gibt. Es steckt in irgendeinem Gerät in der Halle, nur in welchem, sagt kein Papier. Ein Netz, dessen Teilnehmer man nicht benennen kann, ist keine Infrastruktur, sondern eine Ansammlung von Zufällen.

Ein neues Etikett, das fast genauso heißt wie ein altes, macht am Ende beide unbrauchbar. Ich wollte im Dokumentenarchiv einen Prüfstapel für nicht auffindbare Fahrzeugnummern anlegen und hätte ihn beinahe so benannt wie ein bestehendes Etikett, das 152 Dokumente aus einem völlig anderen Prüfauftrag trägt. Die Software vergleicht Namen ohne Rücksicht auf Groß- und Kleinschreibung, beide Stapel wären verschmolzen, und hinterher hätte sie niemand mehr trennen können. Seitdem lese ich erst die vorhandene Liste, bevor ich etwas Neues hineinschreibe.

Ein fehlender Kundenname darf die übrigen erkannten Daten nicht mitreißen, und bei uns tat er es jahrelang doch. In unserer Dokumenten-Pipeline hingen Fahrzeugnummer, Kennzeichen und Betrag an derselben Bedingung wie der Kunde: kein Kunde erkannt, kein einziges Feld gespeichert. 153 von 164 Belegen ohne Kunden standen deshalb nackt im Archiv, obwohl die Erkennung alles sauber gelesen und ins Protokoll geschrieben hatte. Ausgerechnet die Belege, die Nacharbeit brauchen, verloren so jeden Anhaltspunkt. Wer das Unsichere verwirft, darf das Sichere nicht mitverwerfen.

Eine Überschrift soll gesucht werden, nicht schön klingen. Zwei meiner Artikel über Loco-Soft ranken für nichts, obwohl über dreitausendvierhundert Betriebe mit dieser Software arbeiten und es im Netz keine unabhängige Anleitung dazu gibt. Der Fehler lag nicht am Inhalt, sondern am Titel: Ich hatte eine Geschichte übertitelt, statt die Frage hinzuschreiben, die ein Nutzer abends wirklich eintippt. Ein Text, den niemand sucht, ist kein Ratgeber, sondern ein Tagebuch.

Eine KI, die öffentlich spricht, darf nur wissen, was auch öffentlich gesagt werden darf. Ich baue gerade einen Interviewer, der mich vor der Kamera befragt, und der eigentliche Hebel war nicht die Technik, sondern das Vorwissen: echte Projekte, harte Zahlen, eigene Fehlschläge, etwa 819 statt 1.176 verarbeiteter Dokumente. Deshalb gilt bei mir eine einfache Regel: Was im Briefing steht, kann die Maschine aussprechen, also stehen dort keine Kundennamen und keine Kennzeichen. Was eine Maschine weiß, sagt sie irgendwann, und selten im passenden Moment.

Automatisch im Dokumentenarchiv landen sollte ein Messprotokoll nur, wenn klar ist, zu welchem Auftrag es gehört. Unser Achsmessstand liefert Zeitpunkt und eine Kennung, aber Kunde, Auftrag und Kilometerstand bleiben in seiner Schnittstelle immer leer, bei allen 122 Messungen im Bestand. Deshalb fügt der Ablauf die vier Berichte zusammen, druckt sie und schickt sie per Mail, und die Zuordnung macht ein Mensch. Ein Dokument ohne Bezug ist kein Archiv, sondern ein Fundbüro.

Automatisch ins Dokumentenarchiv sollen Messprotokolle nur, wenn eine Zuordnung dranhängt. Beim Achsmessstand waren in allen 122 gespeicherten Messungen die Felder für Kunde, Auftrag und Kilometerstand leer, weil sie im Werkstattalltag niemand eintippt. Deshalb landen die Protokolle bei uns erst in einem Sammelpostfach und nicht im Archiv. Ein Archiv ohne Zuordnung ist nur ein schnellerer Weg, etwas zu verlieren.

Dass eine Software längst im Netzwerk lief, merkt man an ihrer gemeinsamen Konfigurationsdatei. Wir haben unsere Abgasuntersuchungs-Software auf einen neuen Rechner gezogen, sauber lokal installiert, und erst danach den alten Ordner auf dem Server geöffnet: Datenbank, Lizenz und die Schreibspuren von drei Arbeitsplätzen, bis in diesen Juli hinein. Wir waren also von Mehrplatz auf Einzelplatz umgezogen, ohne es zu wissen, und mussten zurück. Vor jedem Umzug steht die Frage, wo die Daten heute wirklich liegen.

Der Anzeige einer Software kann man nicht glauben, wenn es um die tatsächliche Verkabelung geht. Unsere Abgas-Software zeigte für das Prüfgerät sauber RS232 an, und ich habe eine halbe Stunde nach seriellen Kabeln und COM-Ports gesucht. Am alten Anmelde-PC hingen aber nur Strom und Netzwerk, und das Gerät saß mit eigener Adresse im Netz. Eine Software zeigt, was einmal eingetragen wurde, nicht was hinten am Rechner steckt.

Dass zu einem System irgendein Passwort im Tresor liegt, reicht nicht, es muss das richtige sein. Als ich am UniFi-Controller unseres WLAN eine Port-Einstellung ändern wollte, fand ich im Tresor nur ein Konto mit Lesezugriff; das Admin-Konto mit vollen Rechten war nie abgelegt worden. Von zwei Konten fehlte ausgerechnet das wichtigere, und der vorhandene Eintrag gaukelte Vollständigkeit vor. Eine halbe Dokumentation ist tückischer als gar keine, denn die Lücke fällt erst auf, wenn man sie braucht.

Eine Automatik darf einen offenen Fall bei uns drei Nächte lang behalten, dann muss sie ihn sichtbar an den Menschen übergeben. Belege ohne zugeordneten Kunden bekommen jetzt einen Marker-Tag, und der nächtliche Lauf versucht die Zuordnung nachzuholen, sobald frische Daten da sind. Beim ersten scharfen Lauf löste er 39 von 112 offenen Belegen von allein, der Rest wandert nach der Frist mit sichtbarem Hinweis zu den Kollegen. Eine Automatik, die still auf offenen Fällen sitzt, ist nur eine ordentlichere Form des Vergessens.

Einzeln zugeordnet werden sollte nicht jedes Blatt einer Akte, denn ein Stapel gehoert meist zu einem einzigen Kunden und Fahrzeug. Als Gemma jedes Dokument fuer sich betrachtete, riet es beim Diagnoseausdruck den Geraetehersteller, obwohl das Deckblatt derselben Akte den Halter laengst nannte. Jetzt erbt der ganze Schwung zwischen zwei Trennblaettern denselben Korrespondenten, statt Seite fuer Seite neu zu raten. Wer den Zusammenhang wegwirft, muss ihn auf jedem Blatt neu erfinden.

Alte Massen-Dokumente sollen nicht durch denselben Eingangskorb wie die tägliche Post. Wir haben 6215 Altbelege vom alten Werkstatt-Laufwerk in unsere Dokumentenablage geholt, gut dreitausendneunhundert davon Fahrzeugunterlagen. Hätten wir sie in den normalen Posteingang gekippt, hätten die Kollegen am Tresen tagelang zwischen frischer Tagespost und altem Bestand gesucht. Also bekamen sie einen eigenen Marker und gingen direkt ins Archiv. Wer altes Wasser einlässt, darf damit nicht die frische Quelle trüben.

Ein Beleg soll gleich behandelt werden, egal ob er aus dem Scanner kommt, per Mail oder von Hand hochgeladen wird. Bei uns durchläuft jedes Dokument denselben vollen Flow: Texterkennung, Gemma für den Inhalt, dann Kontext und Felder. Seit die Warteschlange läuft, bekommt jedes neue Dokument denselben Stempel und wird angereichert, ganz gleich auf welchem Weg es hereinkam. Der Weg herein darf nicht über die Sorgfalt entscheiden.

Was eine Kundenakte zusammenhält, ist die Fahrgestellnummer, nicht der Kundenname. Als wir die erste Papierakte digitalisierten, acht Belege zu einem Fahrzeug, stand auf einzelnen Blättern noch ein Vorbesitzer. Der Name wechselt, die Fahrgestellnummer bleibt, also haben wir sie fest auf jeden Beleg geschrieben und den Kunden nur weich zugeordnet. Man bindet eine Sache an das, was sich nicht ändert, nicht an das, was heute zufällig obenauf liegt.

Einen Beleg, dessen Kunde beim Einscannen noch nicht im System stand, ordnet man zu, indem man es später noch einmal versucht, statt gleich aufzugeben. Unser Nacht-Job im Paperless gleicht neu gescannte Dokumente ohne Korrespondent noch ein paar Nächte lang gegen die inzwischen aktualisierten Loco-Soft-Daten ab; beim ersten Lauf löste er 28 von 99 offenen Belegen. Bleibt einer nach drei Nächten ungeklärt, bekommt er den Stempel ZU BEARBEITEN und landet beim Menschen. Manches ordnet sich von selbst, wenn man der Welt Zeit gibt aufzuholen, den Rest reicht man weiter, statt ihn stumm liegenzulassen.

Einen Tag, den niemand vergeben hat, hängt nicht der Code an, sondern das System selbst. In unserem Dokumentenarchiv Paperless bekam jeder eingelesene Beleg die Markierung ZU BEARBEITEN, obwohl mein Import-Skript sie nie setzte. Der Grund war eine einzige Voreinstellung: der Tag galt als Eingangskorb und wird damit automatisch an alles gehängt, was hereinkommt. Dieselbe Mechanik hatte schon einmal 581 Belege stumm markiert. Wenn etwas auftaucht, das du nicht gesetzt hast, such nicht im eigenen Code, sondern in den Voreinstellungen.

Ein kuratiertes Gedächtnis reicht nicht, um die eigene Geschichte zu erzählen. Als ich für eine Artikelreihe meine KI-Reise rekonstruierte, fehlte in der aus Merknotizen gebauten Zeitleiste ein ganzes Projekt, das Loco-Soft Hilfe-System, an dem ich wochenlang gebaut hatte. Erst die vollständigen Sitzungsprotokolle, rund sechshundert Einträge zurück bis Ende Oktober, brachten es zurück. Die aufgeräumte Zusammenfassung vergisst das Unscheinbare, der lückenlose Rohbestand erinnert sich. Wer nur seine Höhepunkte notiert, schreibt am Ende eine geschönte Geschichte.

Wenn ein erfahrener Kollege in Rente geht, nimmt er ohne Vorsorge sein halbes Wissen mit. Bei uns ist genau das passiert: vieles, was er über Jahrzehnte konnte, stand nur in seinem Kopf und nirgends sonst. Darum halten wir jetzt jeden wiederkehrenden Ablauf, etwa die Service-Annahme, als Diagramm im Nextcloud-Handbuch fest. Jeder so festgehaltene Prozess wird später Baustein einer eigenen Werkstatt-KI, die den Kollegen hilft, wenn sie nicht weiterwissen. Ein Kopf geht in Rente, ein aufgeschriebener Handgriff bleibt.

Bevor man zwei Systeme verbindet, schreibt man erst auf, welche Daten überhaupt schon vorhanden sind. Bevor ich unsere Dokumentenablage an Loco-Soft koppeln wollte, habe ich eine ganze Sitzung lang nur gelesen und kartiert: drei Loco-Soft-Datenbanken, allein eine davon mit fünfzehn Tabellen, dazu eine SOAP-Schnittstelle, über die dieselben Fahrzeugdaten noch einmal kommen. Keine Zeile Code, nur eine Landkarte. Wer zuerst das Gelände kennt, baut die Brücke an der richtigen Stelle.

Wenn Footer und Impressum verschiedene Orte nennen, vereinheitlicht man beide auf die rechtlich verbindliche Anschrift aus dem Impressum. Bei einer Prüfung meiner Seite, gebaut mit Astro, stand im Footer die eine Stadt und im Impressum eine andere Gemeinde der Region. Beides war gut gemeint, zusammen wirkte es widersprüchlich. Das Impressum nach Paragraf fünf DDG braucht genau eine ladungsfähige Anschrift, nicht zwei Versionen. Wer rechtlich erreichbar sein muss, darf sich nicht zwischen zwei Orten verstecken.

In meinem Impressum steht jetzt das Digitale-Dienste-Gesetz und nicht mehr das Telemediengesetz, weil der Gesetzgeber das alte Gesetz abgelöst hat. Beim Überarbeiten der Rechtsseiten habe ich neun Verweise von TMG auf DDG umgestellt, Paragraf für Paragraf, vom sichtbaren Text bis in die Meta-Beschreibung. Solche Texte veralten still, niemand bekommt eine Mahnung dafür. Ein Rechtstext ist nur so verlässlich wie der Tag, an dem man ihn zuletzt gelesen hat.

Eine Änderung überlebt den Neustart nur, wenn sie an der dauerhaften Stelle landet und nicht im flüchtigen Speicher. Ich hatte die Netzwerkadresse unserer Ladesäule über das Verwaltungsprotokoll gesetzt, alles lief, und nach dem nächsten Neustart stand wieder der alte Wert da. Erst als ich die Zeile in die dauerhafte Konfiguration der Säule schrieb, blieb sie. Was nicht festgeschrieben ist, ist nur geborgt, bis der Strom einmal weg war.

Ein Zugang, den man oft benutzt, aber nie ablegt, ist verloren, sobald das Gedächtnis aussetzt. Wir hatten die Zugangsdaten für die Loco-Soft SOAP-Schnittstelle im April einmal ermittelt und seither immer wieder verwendet, doch die Notiz, sie in den Passwort-Tresor Vaultwarden zu legen, blieb liegen. Als ich sie jetzt brauchte, fand ich sie nirgends, weder im Tresor noch auf einem Server, und das war mein Fehler. Etwas oft zu benutzen ist nicht dasselbe wie es zu besitzen, erst das Ablegen macht aus Wissen einen Bestand.

Als zentrale Dokumentenablage taugt unser Werkstatt-Programm nicht. Loco-Soft hat auf dem Server nur fünf Gigabyte frei, der TWAIN-Scanner läuft unter Windows 11 nicht mehr, und für jeden Beleg muss man erst den Kunden öffnen und das Bild von Hand kopieren. Deshalb liegen die Belege jetzt in einem eigenen Dokumentensystem, sauber durchsuchbar und von überall erreichbar. Ein Programm ist gut in dem, wofür es gebaut wurde, und nur darin.

Der Plan für ein Vorhaben sollte leben, bevor man die erste Schraube anfasst, an einem festen Ort, den auch andere sehen können. Ich habe es mir zur Regel gemacht, vor jedem größeren IT-Vorhaben zuerst ein Projekt in OpenProject mit Aufgaben und Meilensteinen anzulegen und ein eigenes Verzeichnis für die Dokumentation, und erst danach zu bauen. Ein Plan im Kopf ist nach einer Woche weg, ein Plan an einem festen Ort bleibt für alle nachvollziehbar.

Ein Firmendokument gehoert nicht der Person, die es einscannt, sondern niemandem persoenlich. Bei uns hingen siebenhundertneunundachtzig Dokumente am Konto eines einzelnen Mitarbeiters, und ich fragte mich, was passiert, wenn der einmal kuendigt. Heute entscheidet das Scan-Profil am Geraet: Firmenpost bekommt keinen Eigentuemer und laeuft ueber den Posteingang, nur Privates bleibt an einer Person. Was allen gehoert, sollte an keinem Einzelnen haengen.

Weil ein falsch gesetzter Schalter, den niemand dokumentiert hat, genauso wirkt wie ein großer Defekt. Bei der Mail-Einrichtung lag es am Ende an einem einzigen Port, 465 statt 587, der anders sein musste als überall beschrieben. Stunden hingen an einer Zeile. Wer sie findet und aufschreibt, schenkt dem nächsten den ganzen Tag.

Sofort aufschreiben, nicht erst am Ende. Beim Lernen speichere ich jede Erklärung und jedes Bild ab, sobald es da ist. Wissen, das nur im Verlauf eines Chats bleibt, ist nach der Sitzung weg. Was nicht festgehalten wird, war am Ende keine Erkenntnis, nur ein Moment.

Das System. Unsere Doku behauptete an einer Stelle eine alte Datenbank, live lief längst eine andere. Das Repo beschreibt, wie es sein sollte, der Server zeigt, wie es ist. Ich handle nach dem, was wirklich läuft, und ziehe die Doku nach, nicht umgekehrt.

Nein, hinter jedem Satz steht ein Urteil, das jemand erstritten hat. Wir haben unseren Datenschutz auf Basis konkreter Gerichtsentscheidungen formuliert, nicht aus einem Generator. Wer ihn ernst nimmt, schützt nicht sich, sondern die Leute, deren Daten er verwaltet.

Weil sie einem sonst nicht wirklich gehört. Was nicht dokumentiert ist, gehört dem, der es zuletzt angefasst hat, und der ist vielleicht weg. Wir haben Netzwerk, Server und Zugänge sauber aufgeschrieben. Eine Topologie auf Papier ist ein Stück Unabhängigkeit, gerade im Kleinbetrieb.

Bis aufs Zeichen. Falsche Firmierung in Impressum oder Rechtstexten ist tatsächlich abmahnbar. Wir haben alle Vorkommen auf die handelsregister-korrekte Schreibweise vereinheitlicht. Sorgfalt im Kleinen ist keine Pedanterie, sie ist Respekt vor dem eigenen Haus und schützt vor unnötigem Ärger.

Gerade die. Ein verschwiegenes Risiko verschwindet nicht, es wartet nur auf den ungünstigsten Moment. Wir führen eine offene Liste der bekannten Schwachstellen, auch der peinlichen. Verschwiegene Risiken werden teuer, benannte werden abgearbeitet.