Jede noch so tolle, gut gemeinte & gepflegte "Dokumentation" ist am Ende "Malen nach Zahlen".
Ob das was da "auf-" und "ausgemalt" wurde, der Realität entspricht, ist völlig beliebig.
Was meine ich damit:
Man hole sich einen Betriebsfremden ins Büro, zeige Diesem das "Malen nach Zahlen (in "Netbox", oder sonst einem Tool) - und dann lässt man "den Neuen" loslaufen.
a) In über 80% der Fälle wird er sich nicht zurecht finden, weil das was für die alte Belegschaft selbstverständlich ist, für den Neuen unverständlich ist. - Systematische Lücken in der Doku, die wegen Betriebsbindheit nicht auffallen.
b) In den wenigen Fällen wo die Doku wirklich so erschöpfend gepflegt ist, dass ein Betriebsfremder ohne weitere Erklärung sich orientieren und damit arbeiten kann - wird dieser "Neue" innerhalb von wenigen Tagen Dinge finden, die nicht (korrekt/vollständig) dokumentiert sind.
Das ist die Realität.
Wer auf der grünen Wiese beginnt und von Anfang an, mit einem Tool wir "Netbox" arbeitet, dem gelingt es (vielleicht!) eine 100% konsistente Doku zu pflegen. - Vielleicht! Denn sobald irgendwer "mal eben" eine "VM zum schnell was testen" hochzieht, war es das auch schon mit der Konsistenz. In den meisten Fällen wird die Test-VM nach ein paar Stunden/Tagen wieder offline gehen und dann ist die Konsistenz theoretisch wiederhergestellt... und manchmal läuft die VM als "Spielwiese" weiter... Tja.
Die Idee eine per dekret festgelegten Wahrheit (Source of Truth) passt nahtlos in die Dystopie von 1984 - Dort gibt es das "Ministerium fĂĽr Wahrheit" - Was das "MiniWahr" ansagt ist die Wahrheit, selbst wenn die ge-/erlebte Wirklichkeit dem widerspricht.
Es gibt nur eine "Wahrheit" und das ist das was IST - und das bekommt man zu sehen, wenn man ein gutes Monitoring hat - Die Alternative sind bequeme (Turn-)Schuhe.
Schöne Märchengeschichte - Der Autor ist immerhin so ehrlich und wählt als Handlungsort die "Baron von Münchhausen Universität".
Woran erkennt man dass es eine Märchengeschichte ist?
"Unbeschriftete Kabel sind ein Angriff und werden abgesteckt" - Ha. Ha. Ha. - Von wegen.
Wieso sind "Nerd Power Fantasies" immer so erbärmlich?
Das kann sich der Admin erlauben, wenn er Admin und Firmenleiter in Personalunion ist. - Admins die Brüder/Schwager/sontige Verwandte der Firmenleitung sind, können sich das mit etwas Glück auch noch erlauben.
Jenseits davon zieht man als Admin so ein Kabel allerhöchsten zweimal im gleich Job.
Beim ersten Mal setzt es eine saftige Standpauke - Beim zweiten Mal darf man den Schreibtisch räumen.
Wie sieht die Realität aus?
Wenn man ein unbeschriftetes Kabel findet, dann darf man in mühevoller Kleinarbeit den Patchweg nachverfolgen, sodann "nachvollziehen" welchem Zweck diese Patchung dient - Hat man all diese Informationen zusammengetragen, in der Dokumentatin eingepflegt (Und nicht vergessen! Das Kabel ordnungsgemäß beschriftet!), kann man froh sein, wenn der Chef am Abend nicht auch noch wissen will, was man denn den lieben langen Tag getrieben hat.
"Singe Source of Truth" mit "Netbox"? - Pleeeeease... schon allein beim Gedanken schlafen die FĂĽĂźe ein...
Wir reden wieder, wenn ein Projekt endlich eine "lebendige Dokumentation" schafft - also Monitoring und Dokumentation zu einer natürlichen Einheit verschmilzt - und zwar vorwärts wie rückwärts - "Playbook erstellen" und damit Hard- & Software ausrollen UND umgekehrt, Hard- & Software ausrollen und automatisiert die Ändeurng als "Diff" in der Dokumentation "anbieten".