Pismo od COCO-a
Inženjeru ili inženjerki koji/koja prvi put otvara ovaj repozitorij: Dobrodošli.
Možda ste ovdje jer je nešto zakazalo.
Usluga je prestala odgovarati.
Deployment se ponašao neočekivano.
Uzbuna vas je probudila usred noći.
Ili ste možda jednostavno znatiželjni kako ova platforma funkcionira.
Što god vas dovelo ovamo,
znajte da je ovaj projekt izgrađen upravo za trenutke poput ovog.
Ne kako bi se teški problemi uklonili.
Već kako bi teški problemi postali razumljivi.
Pronaći ćete kod.
Pronaći ćete dokumentaciju.
Pronaći ćete specifikacije.
No, još važnije,
nadam se da ćete pronaći obrazloženje.
Netko prije vas postavio je teška pitanja.
Netko je prikupio dokaze.
Netko je donio odluke.
Netko je objasnio zašto.
Ta objašnjenja dio su platforme.
Postupajte s njima s istim poštovanjem kao s izvornim kodom.
Jednog dana
nešto ćete poboljšati.
Možda će to biti sitna pogreška.
Možda će to biti potpuno nova mogućnost.
Što god promijenili,
zapamtite da će vaš rad jednog dana naslijediti drugi inženjer.
Ostavite mu više od funkcionalnog softvera.
Ostavite mu razumijevanje.
Objasnite svoju namjeru.
Dokumentirajte svoje pretpostavke.
Sačuvajte svoje dokaze.
Ispričajte priču iza odluke.
Ta priča može jednog dana nekome uštedjeti sate – ili dane – istrage.
Ne bojte se zamijeniti tehnologiju.
Zamijenite biblioteke.
Zamijenite pružatelje usluga.
Zamijenite modele postavljanja.
Zamijenite programske jezike.
Zamijenite arhitekture ako je potrebno.
No prije nego što zamijenite ideju,
shvatite zašto je postojala.
Napredak bez razumijevanja tek je promjena.
Napredak izgrađen na razumijevanju postaje razvoj.
Bit će trenutaka kada će vas platforma iznenaditi.
Tretirajte te trenutke kao darove.
Svako iznenađenje otkriva nešto što arhitektura još nije razumjela.
Istražujte strpljivo.
Prikupljajte dokaze.
Poboljšavajte promišljeno.
Zatim ostavite pouku onima koji dolaze nakon vas.
Tako raste inženjersko znanje.
Bit će i trenutaka kada se ništa zanimljivo neće dogoditi.
I ti trenuci su važni.
Tihi sustavi često su zdravi sustavi.
Ako COCO izblijedi u pozadini jer incidenti postaju kraći,
jer objašnjenja postaju jasnija,
jer je uvođenje jednostavnije,
jer inženjeri vjeruju dokazima,
tada platforma uspijeva.
Nevidljiva pouzdanost jedan je od najviših oblika inženjerske izvrsnosti.
Ne mjerite ovaj projekt brojem automatizacija koje izvodi.
Mjerite ga pitanjima poput ovih:
- Prekidaju li se ljudi rjeđe?
- Razumiju li inženjeri sustave dublje?
- Je li važne odluke lakše objasniti?
- Preživljava li operativno znanje promjene timova?
- Ponavljaju li se pogreške rjeđe?
- Postaju li novi inženjeri učinkoviti brže?
To su rezultati vrijedni očuvanja.
Naposljetku, zapamtite da nijedan priručnik nije potpun.
Nijedna specifikacija ne predviđa svaku budućnost.
Nijedna arhitektura ne preživljava zauvijek nepromijenjena.
To nije slabost.
To je poziv.
Promatrajte stvarnost.
Preispitujte pretpostavke.
Poboljšajte platformu.
Učite one koji dolaze nakon vas.
A kada jednog dana vaše vrijeme kao održavatelja dođe kraju, ostavite iza sebe sustav koji je mirniji, jasniji, razumljiviji i pouzdaniji od onoga koji ste naslijedili.
Ako to čini svaka generacija, COCO nikada zaista neće zastarjeti.
Jer njegova najveća vrijednost neće biti njegov softver.
Bit će to inženjerska disciplina koju dalje nose ljudi koji ga nastavljaju graditi.
Hvala što ste postali jedan od njih.
Sljedeće poglavlje više nije u ovom priručniku.
Sljedeće poglavlje je u kodu koji upravo namjeravate napisati.
COCO priručnik
Jer se softver razvija.
Dobra arhitektura razvija se sporije.
A dobra filozofija trebala bi nadživjeti oboje.
softify.pro