List od COCO

Inžinierke alebo inžinierovi, ktorý toto úložisko otvára po prvý raz: Vitajte.
Možno ste tu, pretože niečo zlyhalo.
Služba prestala odpovedať.
Nasadenie sa správalo neočakávane.
Upozornenie vás zobudilo uprostred noci.
Alebo vás jednoducho zaujíma, ako táto platforma funguje.
Nech vás sem priviedlo čokoľvek, vedzte:
Tento projekt bol postavený presne pre takéto chvíle.
Nie na to, aby odstraňoval náročné problémy.
Ale aby náročné problémy urobil zrozumiteľnými.
Nájdete kód.
Nájdete dokumentáciu.
Nájdete špecifikácie.
No čo je dôležitejšie:
Dúfam, že nájdete zdôvodnenia.
Niekto pred vami kládol náročné otázky.
Niekto zbieral dôkazy.
Niekto robil rozhodnutia.
Niekto vysvetlil prečo.
Tieto vysvetlenia sú súčasťou platformy.
Zaobchádzajte s nimi s rovnakým rešpektom ako so zdrojovým kódom.
Jedného dňa niečo vylepšíte.
Možno pôjde o drobnú chybu.
Možno pôjde o úplne novú schopnosť.
Nech zmeníte čokoľvek, pamätajte: Raz vašu prácu prevezme iná osoba.
Zanechajte jej viac než len funkčný softvér.
Zanechajte jej porozumenie.
Vysvetlite svoj zámer.
Zdokumentujte svoje predpoklady.
Zachovajte svoje dôkazy.
Vyrozprávajte príbeh za rozhodnutím.
Tento príbeh môže niekomu raz ušetriť hodiny - alebo dni - skúmania.
Nebojte sa nahrádzať technológiu.
Nahraďte knižnice.
Nahraďte poskytovateľov.
Nahraďte modely nasadenia.
Nahraďte programovacie jazyky.
Nahraďte architektúry, ak je to potrebné.
No skôr než nahradíte myšlienku, pochopte, prečo existovala.
Pokrok bez porozumenia je len zmena.
Pokrok postavený na porozumení sa stáva vývojom.
Prídu chvíle, keď vás platforma prekvapí.
Zaobchádzajte s týmito chvíľami ako s darmi.
Každé prekvapenie odhaľuje niečo, čomu architektúra ešte nerozumela.
Skúmajte trpezlivo.
Zbierajte dôkazy.
Vylepšujte premyslene.
A zanechajte z toho ponaučenie pre tých, ktorí prídu po vás.
Tak rastie inžinierske poznanie.
Prídu aj chvíle, keď sa nestane nič zaujímavé.
Aj tieto chvíle sa počítajú.
Tiché systémy sú často zdravé systémy.

Ak COCO ustúpi do pozadia,
pretože incidenty sú kratšie,
pretože vysvetlenia sú jasnejšie,
pretože zaškolenie je jednoduchšie,
pretože inžinierky a inžinieri dôverujú dôkazom, potom je platforma úspešná.
Neviditeľná spoľahlivosť je jednou z najvyšších foriem technickej excelentnosti.
Nemerajte tento projekt počtom automatizácií, ktoré vykonáva.
Merajte ho otázkami, ako sú tieto:

• Sú ľudia prerušovaní menej často?
• Rozumejú inžinierky a inžinieri systémom hlbšie?
• Dajú sa dôležité rozhodnutia ľahšie vysvetliť?
• Prežije prevádzkové poznanie zmeny tímov?
• Opakujú sa chyby menej často?
• Stávajú sa noví inžinieri efektívnymi rýchlejšie?

Toto sú výsledky, ktoré stoja za zachovanie.
Napokon pamätajte: Žiadna príručka nie je úplná.
Žiadna špecifikácia nepredpovie každú budúcnosť.
Žiadna architektúra neprežije naveky nezmenená.
To nie je slabosť.
Je to pozvanie.
Pozorujte realitu.
Spochybňujte predpoklady.
Vylepšujte platformu.
Učte tých, ktorí prídu po vás.
A keď sa jedného dňa skončí váš vlastný čas ako správkyne alebo správcu, zanechajte systém, ktorý je pokojnejší, jasnejší, zrozumiteľnejší, a dôveryhodnejší než ten, ktorý ste prevzali.

Ak to urobí každá generácia, COCO nikdy skutočne nezastará.
Pretože jeho najväčším kapitálom nebude jeho softvér.
Bude ním inžinierska disciplína, ktorú ďalej nesú ľudia, ktorí ho ďalej budujú.
Ďakujeme, že ste sa stali jedným z nich.
Ďalšia kapitola už nie je v tejto príručke.
Ďalšia kapitola je v kóde, ktorý čoskoro napíšete.

Príručka COCO

Pretože softvér sa vyvíja.
Dobrá architektúra sa vyvíja pomalšie.
A dobrá filozofia by mala prežiť obe.

softify.pro