Pismo od COCO

Inženjerki ili inženjeru koji prvi put otvara ovaj repozitorijum: Dobrodošli.
Možda ste ovde jer je nešto pošlo po zlu.
Servis je prestao da odgovara.
Deployment se ponašao neočekivano.
Alarm vas je probudio usred noći.
Ili ste jednostavno radoznali kako ova platforma funkcioniše.
Šta god da vas je dovelo ovde, znajte:
Ovaj projekat je izgrađen tačno za ovakve trenutke.
Ne da bi uklonio teške probleme.
Već da bi teške probleme učinio razumljivim.
Naći ćete kod.
Naći ćete dokumentaciju.
Naći ćete specifikacije.
Ali što je još važnije:
Nadam se da ćete naći obrazloženja.
Neko pre vas je postavljao teška pitanja.
Neko je prikupljao dokaze.
Neko je donosio odluke.
Neko je objasnio zašto.
Ta objašnjenja su deo platforme.
Tretirajte ih sa istim poštovanjem kao izvorni kod.
Jednog dana ćete nešto poboljšati.
Možda će to biti sitan bag.
Možda će to biti potpuno nova mogućnost.
Šta god da promenite, zapamtite: Jednom će neko drugi preuzeti vaš rad.
Ostavite mu više od funkcionalnog softvera.
Ostavite mu razumevanje.
Objasnite svoju nameru.
Dokumentujte svoje pretpostavke.
Sačuvajte svoje dokaze.
Ispričajte priču iza odluke.
Ta priča može jednog dana nekome uštedeti sate - ili dane - istraživanja.
Ne bojte se da menjate tehnologiju.
Zamenite biblioteke.
Zamenite provajdere.
Zamenite modele deploymenta.
Zamenite programske jezike.
Zamenite arhitekture, ako je potrebno.
Ali pre nego što zamenite ideju, razumite zašto je postojala.
Napredak bez razumevanja je samo promena.
Napredak izgrađen na razumevanju postaje razvoj.
Biće trenutaka kada će vas platforma iznenaditi.
Tretirajte te trenutke kao poklone.
Svako iznenađenje otkriva nešto što arhitektura još nije razumela.
Istražujte strpljivo.
Prikupljajte dokaze.
Poboljšavajte promišljeno.
I ostavite pouku iz toga za one koji dolaze posle vas.
Tako raste inženjersko znanje.
Biće i trenutaka kada se ništa zanimljivo ne dešava.
I ti trenuci se računaju.
Tihi sistemi su često zdravi sistemi.

Ako se COCO povuče u pozadinu,
jer incidenti postaju kraći,
jer objašnjenja postaju jasnija,
jer je uvođenje novih ljudi lakše,
jer inženjeri veruju dokazima, onda je platforma uspešna.
Nevidljiva pouzdanost je jedan od najviših oblika inženjerske izvrsnosti.
Ne merite ovaj projekat po broju automatizacija koje izvršava.
Merite ga pitanjima poput ovih:

• Da li su ljudi ređe prekidani?
• Da li inženjeri dublje razumeju sisteme?
• Da li je lakše objasniti važne odluke?
• Da li operativno znanje preživi promene tima?
• Da li se greške ređe ponavljaju?
• Da li novi inženjeri brže postaju efikasni?

To su rezultati koje vredi sačuvati.
Na kraju, zapamtite: Nijedan priručnik nije potpun.
Nijedna specifikacija ne predviđa svaku budućnost.
Nijedna arhitektura ne preživi zauvek nepromenjena.
To nije slabost.
To je poziv.
Posmatrajte stvarnost.
Dovodite u pitanje pretpostavke.
Poboljšavajte platformu.
Učite one koji dolaze posle vas.
A kada se jednog dana završi vaše vreme kao održavaoca, ostavite sistem koji je mirniji, jasniji, razumljiviji, i pouzdaniji od onog koji ste preuzeli.

Ako to čini svaka generacija, COCO nikada zaista neće zastareti.
Jer njegov najveći kapital neće biti njegov softver.
Biće to inženjerska disciplina koju dalje nose ljudi koji ga nastavljaju da grade.
Hvala vam što ste postali jedan od njih.
Sledeće poglavlje se više ne nalazi u ovom priručniku.
Sledeće poglavlje se nalazi u kodu koji ćete uskoro napisati.

Priručnik za COCO

Jer se softver razvija.
Dobra arhitektura se razvija sporije.
A dobra filozofija bi trebalo da nadživi oboje.

softify.pro