Dopis od COCO

Inženýrce nebo inženýrovi, který tento repozitář otevírá poprvé: Vítejte.
Možná jste zde, protože něco selhalo.
Služba přestala odpovídat.
Nasazení se zachovalo neočekávaně.
Upozornění vás probudilo uprostřed noci.
Nebo vás jednoduše zajímá, jak tato platforma funguje.
Ať vás sem přivedlo cokoli, vězte:
Tento projekt byl postaven přesně pro takové chvíle.
Ne proto, aby odstraňoval obtížné problémy.
Ale aby obtížné problémy učinil srozumitelnými.
Najdete kód.
Najdete dokumentaci.
Najdete specifikace.
Ale co je důležitější:
Doufám, že najdete zdůvodnění.
Někdo před vámi kladl obtížné otázky.
Někdo sbíral důkazy.
Někdo dělal rozhodnutí.
Někdo vysvětlil proč.
Tato vysvětlení jsou součástí platformy.
Zacházejte s nimi se stejným respektem jako se zdrojovým kódem.
Jednoho dne něco vylepšíte.
Možná půjde o drobnou chybu.
Možná půjde o zcela novou schopnost.
Ať změníte cokoli, pamatujte: Jednou vaši práci převezme jiná osoba.
Zanechte jí více než jen funkční software.
Zanechte jí porozumění.
Vysvětlete svůj záměr.
Zdokumentujte své předpoklady.
Zachovejte své důkazy.
Vyprávějte příběh za rozhodnutím.
Tento příběh může jednou někomu ušetřit hodiny - nebo dny - zkoumání.
Nebojte se nahrazovat technologii.
Nahraďte knihovny.
Nahraďte poskytovatele.
Nahraďte modely nasazení.
Nahraďte programovací jazyky.
Nahraďte architektury, je-li to nutné.
Než ale nahradíte myšlenku, pochopte, proč existovala.
Pokrok bez porozumění je jen změna.
Pokrok postavený na porozumění se stává vývojem.
Přijdou chvíle, kdy vás platforma překvapí.
Zacházejte s těmito chvílemi jako s dary.
Každé překvapení odhaluje něco, čemu architektura ještě nerozuměla.
Zkoumejte trpělivě.
Sbírejte důkazy.
Vylepšujte promyšleně.
A zanechte z toho ponaučení pro ty, kdo přijdou po vás.
Tak roste inženýrské poznání.
Přijdou i chvíle, kdy se nestane nic zajímavého.
I tyto chvíle se počítají.
Tiché systémy jsou často zdravé systémy.

Pokud COCO ustoupí do pozadí,
protože incidenty jsou kratší,
protože vysvětlení jsou jasnější,
protože zaškolení je snazší,
protože inženýrky a inženýři důvěřují důkazům, pak je platforma úspěšná.
Neviditelná spolehlivost je jednou z nejvyšších forem technické excelence.
Neměřte tento projekt počtem automatizací, které provádí.
Měřte ho otázkami, jako jsou tyto:

• Jsou lidé přerušováni méně často?
• Rozumí inženýrky a inženýři systémům hlouběji?
• Dají se důležitá rozhodnutí snáze vysvětlit?
• Přežije provozní poznání změny týmů?
• Opakují se chyby méně často?
• Stávají se noví inženýři efektivními rychleji?

Toto jsou výsledky, které stojí za uchování.
Nakonec pamatujte: Žádná příručka není úplná.
Žádná specifikace nepředpoví každou budoucnost.
Žádná architektura nepřežije navždy nezměněná.
To není slabost.
Je to pozvání.
Pozorujte realitu.
Zpochybňujte předpoklady.
Vylepšujte platformu.
Učte ty, kdo přijdou po vás.
A až jednoho dne skončí váš vlastní čas jako správkyně nebo správce, zanechte systém, který je klidnější, jasnější, srozumitelnější, a důvěryhodnější než ten, který jste převzali.

Pokud to udělá každá generace, COCO nikdy skutečně nezastará.
Protože jeho největším kapitálem nebude jeho software.
Bude jím inženýrská disciplína, kterou dál nesou lidé, kteří ho dál budují.
Děkujeme, že jste se stali jedním z nich.
Další kapitola už není v této příručce.
Další kapitola je v kódu, který za chvíli napíšete.

Příručka COCO

Protože software se vyvíjí.
Dobrá architektura se vyvíjí pomaleji.
A dobrá filozofie by měla přežít obě.

softify.pro