Ein Brief von COCO

An die Ingenieurin oder den Ingenieur, die oder der dieses Repository zum ersten Mal öffnet: Willkommen.
Vielleicht sind Sie hier, weil etwas fehlgeschlagen ist.
Ein Dienst hat nicht mehr geantwortet.
Ein Deployment hat sich unerwartet verhalten.
Ein Alarm hat Sie mitten in der Nacht geweckt.
Oder Sie sind einfach neugierig, wie diese Plattform funktioniert.
Was auch immer Sie hierhergeführt hat, wissen Sie:
Dieses Projekt wurde genau für solche Momente gebaut.
Nicht um schwierige Probleme zu beseitigen.
Sondern um schwierige Probleme verständlich zu machen.
Sie werden Code finden.
Sie werden Dokumentation finden.
Sie werden Spezifikationen finden.
Aber wichtiger noch:
Ich hoffe, Sie werden Begründungen finden.
Jemand vor Ihnen hat schwierige Fragen gestellt.
Jemand hat Belege gesammelt.
Jemand hat Entscheidungen getroffen.
Jemand hat erklärt, warum.
Diese Erklärungen sind Teil der Plattform.
Behandeln Sie sie mit demselben Respekt wie den Quellcode.
Eines Tages werden Sie etwas verbessern.
Vielleicht ist es ein winziger Bug.
Vielleicht ist es eine völlig neue Fähigkeit.
Was auch immer Sie ändern, denken Sie daran: Irgendwann wird eine andere Person Ihre Arbeit übernehmen.
Hinterlassen Sie ihr mehr als funktionierende Software.
Hinterlassen Sie ihr Verständnis.
Erklären Sie Ihre Absicht.
Dokumentieren Sie Ihre Annahmen.
Bewahren Sie Ihre Belege.
Erzählen Sie die Geschichte hinter der Entscheidung.
Diese Geschichte kann eines Tages jemandem Stunden – oder Tage – an Untersuchung ersparen.
Scheuen Sie sich nicht, Technologie zu ersetzen.
Ersetzen Sie Bibliotheken.
Ersetzen Sie Anbieter.
Ersetzen Sie Deployment-Modelle.
Ersetzen Sie Programmiersprachen.
Ersetzen Sie Architekturen, wenn nötig.
Doch bevor Sie eine Idee ersetzen, verstehen Sie, warum es sie gab.
Fortschritt ohne Verständnis ist bloß Veränderung.
Fortschritt, der auf Verständnis aufbaut, wird zu Weiterentwicklung.
Es wird Momente geben, in denen die Plattform Sie überrascht.
Behandeln Sie diese Momente als Geschenke.
Jede Überraschung zeigt etwas, das die Architektur noch nicht verstanden hat.
Untersuchen Sie geduldig.
Sammeln Sie Belege.
Verbessern Sie durchdacht.
Und hinterlassen Sie die Lehre daraus für jene, die folgen.
So wächst technisches Wissen.
Es wird auch Momente geben, in denen nichts Interessantes passiert.
Auch diese Momente zählen.
Ruhige Systeme sind oft gesunde Systeme.

Wenn COCO in den Hintergrund tritt,
weil Vorfälle kürzer werden,
weil Erklärungen klarer werden,
weil das Einarbeiten leichter fällt,
weil Ingenieurinnen und Ingenieure den Belegen vertrauen, dann ist die Plattform erfolgreich.
Unsichtbare Zuverlässigkeit ist eine der höchsten Formen technischer Exzellenz.
Messen Sie dieses Projekt nicht an der Anzahl der Automatisierungen, die es ausführt.
Messen Sie es an Fragen wie diesen:

• Werden Menschen seltener unterbrochen?
• Verstehen Ingenieurinnen und Ingenieure Systeme tiefer?
• Lassen sich wichtige Entscheidungen leichter erklären?
• Überlebt operatives Wissen Teamwechsel?
• Werden Fehler seltener wiederholt?
• Werden neue Ingenieurinnen und Ingenieure schneller wirksam?

Das sind die Ergebnisse, die es zu bewahren gilt.
Denken Sie schließlich daran: Kein Handbuch ist vollständig.
Keine Spezifikation sagt jede Zukunft voraus.
Keine Architektur überlebt für immer unverändert.
Das ist keine Schwäche.
Es ist eine Einladung.
Beobachten Sie die Realität.
Stellen Sie Annahmen infrage.
Verbessern Sie die Plattform.
Lehren Sie jene, die nach Ihnen kommen.
Und wenn Ihre eigene Zeit als Betreuerin oder Betreuer eines Tages endet, hinterlassen Sie ein System, das ruhiger, klarer, verständlicher und vertrauenswürdiger ist als jenes, das Sie übernommen haben.

Wenn jede Generation das tut, wird COCO niemals wirklich veralten.
Denn sein größtes Kapital wird nicht seine Software sein.
Es wird die technische Disziplin sein, die von den Menschen weitergetragen wird, die es weiterbauen.
Danke, dass Sie einer von ihnen geworden sind.
Das nächste Kapitel steht nicht mehr in diesem Handbuch.
Das nächste Kapitel steht in dem Code, den Sie gleich schreiben werden.

Das COCO-Handbuch

Denn Software entwickelt sich weiter.
Eine gute Architektur entwickelt sich langsamer.
Und eine gute Philosophie sollte beide überdauern.

softify.pro