Levél a COCO-tól

A mérnöknek, aki most nyitja meg ezt a tárolót először: Üdvözöljük.
Lehet, hogy azért van itt, mert valami elromlott.
Egy szolgáltatás leállt.
Egy telepítés váratlanul viselkedett.
Egy riasztás felébresztette éjszaka közepén.
Vagy egyszerűen csak kíváncsi, hogyan működik ez a platform.
Bármi is hozta ide, tudja meg:
Ezt a projektet pontosan az ilyen pillanatokra építették.
Nem azért, hogy eltávolítsa a nehéz problémákat.
Hanem azért, hogy a nehéz problémákat érthetővé tegye.
Kódot fog találni.
Dokumentációt fog találni.
Specifikációkat fog találni.
De ami még fontosabb:
Remélem, indoklásokat is talál.
Valaki ön előtt nehéz kérdéseket tett fel.
Valaki bizonyítékokat gyűjtött.
Valaki döntéseket hozott.
Valaki elmagyarázta, hogy miért.
Ezek a magyarázatok a platform részei.
Kezelje őket ugyanazzal a tisztelettel, mint a forráskódot.
Egy napon fejleszteni fog valamit.
Talán egy apró hibát.
Talán egy teljesen új képességet.
Bármit is változtat, ne feledje: Egyszer valaki más veszi át az ön munkáját.
Hagyjon rá többet, mint működő szoftvert.
Hagyjon rá megértést.
Magyarázza el a szándékát.
Dokumentálja a feltételezéseit.
Őrizze meg a bizonyítékait.
Mesélje el a döntés mögötti történetet.
Ez a történet egy napon órákat - vagy napokat - takaríthat meg valakinek a vizsgálódásból.
Ne féljen technológiát cserélni.
Cseréljen könyvtárakat.
Cseréljen szolgáltatókat.
Cseréljen telepítési modelleket.
Cseréljen programozási nyelveket.
Cseréljen architektúrákat, ha szükséges.
De mielőtt lecserél egy ötletet, értse meg, miért létezett.
A megértés nélküli fejlődés csupán változás.
A megértésre épülő fejlődés fejlesztéssé válik.
Lesznek pillanatok, amikor a platform meglepi.
Kezelje ezeket a pillanatokat ajándékokként.
Minden meglepetés valami olyasmit tár fel, amit az architektúra még nem értett meg.
Vizsgálódjon türelmesen.
Gyűjtsön bizonyítékokat.
Fejlesszen átgondoltan.
És hagyja hátra a tanulságot azoknak, akik követik.
Így nő a mérnöki tudás.
Lesznek olyan pillanatok is, amikor semmi érdekes nem történik.
Ezek a pillanatok is számítanak.
A csendes rendszerek gyakran egészséges rendszerek.

Ha a COCO háttérbe húzódik,
mert az incidensek rövidebbek lesznek,
mert a magyarázatok világosabbak lesznek,
mert a betanulás könnyebbé válik,
mert a mérnökök megbíznak a bizonyítékokban, akkor a platform sikeres.
A láthatatlan megbízhatóság a mérnöki kiválóság egyik legmagasabb formája.
Ne mérje ezt a projektet az elvégzett automatizálások száma alapján.
Mérje az olyan kérdésekkel, mint ezek:

• Ritkábban zavarják meg az embereket?
• Mélyebben értik-e a mérnökök a rendszereket?
• Könnyebb-e elmagyarázni a fontos döntéseket?
• Túléli-e az üzemeltetési tudás a csapatváltásokat?
• Ritkábban ismétlődnek-e a hibák?
• Gyorsabban válnak-e hatékonnyá az új mérnökök?

Ezek azok az eredmények, amelyeket érdemes megőrizni.
Végül ne feledje: Egyetlen kézikönyv sem teljes.
Egyetlen specifikáció sem jósolja meg minden jövőt.
Egyetlen architektúra sem éli túl örökre változatlanul.
Ez nem gyengeség.
Ez egy meghívás.
Figyelje meg a valóságot.
Kérdőjelezze meg a feltételezéseket.
Fejlessze a platformot.
Tanítsa azokat, akik ön után jönnek.
És amikor egy napon véget ér az ön saját ideje karbantartóként, hagyjon hátra egy rendszert, amely nyugodtabb, világosabb, érthetőbb, és megbízhatóbb, mint amit ön örökölt.

Ha minden generáció ezt teszi, a COCO soha nem fog igazán elavulni.
Mert a legnagyobb tőkéje nem a szoftvere lesz.
Hanem a mérnöki fegyelem, amelyet azok az emberek visznek tovább, akik továbbépítik.
Köszönjük, hogy ön is közülük valóvá vált.
A következő fejezet már nem ebben a kézikönyvben található.
A következő fejezet abban a kódban található, amelyet ön mindjárt megír.

A COCO kézikönyv

Mert a szoftver tovább fejlődik.
Egy jó architektúra lassabban fejlődik.
És egy jó filozófiának mindkettőt túl kellene élnie.

softify.pro