List od COCO

Do inżynierki lub inżyniera, który po raz pierwszy otwiera to repozytorium: Witaj.
Być może jesteś tu, ponieważ coś zawiodło.
Usługa przestała odpowiadać.
Wdrożenie zachowało się nieoczekiwanie.
Alarm obudził cię w środku nocy.
A może po prostu jesteś ciekawy, jak działa ta platforma.
Cokolwiek cię tu sprowadziło, wiedz:
Ten projekt został zbudowany dokładnie dla takich chwil.
Nie po to, by usuwać trudne problemy.
Lecz po to, by trudne problemy uczynić zrozumiałymi.
Znajdziesz kod.
Znajdziesz dokumentację.
Znajdziesz specyfikacje.
Ale co ważniejsze:
Mam nadzieję, że znajdziesz uzasadnienia.
Ktoś przed tobą zadawał trudne pytania.
Ktoś zbierał dowody.
Ktoś podejmował decyzje.
Ktoś wyjaśniał dlaczego.
Te wyjaśnienia są częścią platformy.
Traktuj je z tym samym szacunkiem, co kod źródłowy.
Pewnego dnia coś ulepszysz.
Może to będzie drobny błąd.
Może to będzie całkiem nowa funkcjonalność.
Cokolwiek zmienisz, pamiętaj: Kiedyś inna osoba przejmie twoją pracę.
Zostaw jej więcej niż działające oprogramowanie.
Zostaw jej zrozumienie.
Wyjaśnij swój zamysł.
Udokumentuj swoje założenia.
Zachowaj swoje dowody.
Opowiedz historię stojącą za decyzją.
Ta historia może pewnego dnia oszczędzić komuś godzin - lub dni - dochodzenia.
Nie bój się zastępować technologii.
Zastępuj biblioteki.
Zastępuj dostawców.
Zastępuj modele wdrożeń.
Zastępuj języki programowania.
Zastępuj architektury, jeśli to konieczne.
Lecz zanim zastąpisz ideę, zrozum, dlaczego istniała.
Postęp bez zrozumienia to jedynie zmiana.
Postęp zbudowany na zrozumieniu staje się rozwojem.
Będą chwile, gdy platforma cię zaskoczy.
Traktuj te chwile jak dary.
Każde zaskoczenie ukazuje coś, czego architektura jeszcze nie zrozumiała.
Badaj cierpliwie.
Zbieraj dowody.
Ulepszaj przemyślanie.
I zostaw wynikającą z tego lekcję dla tych, którzy przyjdą po tobie.
Tak rośnie wiedza inżynierska.
Będą też chwile, gdy nic interesującego się nie wydarzy.
Te chwile też się liczą.
Ciche systemy są często zdrowymi systemami.

Jeśli COCO odchodzi w cień,
ponieważ incydenty stają się krótsze,
ponieważ wyjaśnienia stają się jaśniejsze,
ponieważ wdrażanie nowych osób staje się łatwiejsze,
ponieważ inżynierowie ufają dowodom, wtedy platforma odnosi sukces.
Niewidzialna niezawodność jest jedną z najwyższych form doskonałości technicznej.
Nie mierz tego projektu liczbą automatyzacji, które wykonuje.
Mierz go pytaniami takimi jak te:

• Czy ludzie są rzadziej przerywani?
• Czy inżynierowie rozumieją systemy głębiej?
• Czy ważne decyzje łatwiej wyjaśnić?
• Czy wiedza operacyjna przetrwa zmiany zespołu?
• Czy błędy powtarzają się rzadziej?
• Czy nowi inżynierowie stają się skuteczni szybciej?

To są rezultaty warte zachowania.
Na koniec pamiętaj: Żaden podręcznik nie jest kompletny.
Żadna specyfikacja nie przewiduje każdej przyszłości.
Żadna architektura nie przetrwa na zawsze niezmieniona.
To nie jest słabość.
To jest zaproszenie.
Obserwuj rzeczywistość.
Kwestionuj założenia.
Ulepszaj platformę.
Ucz tych, którzy przyjdą po tobie.
A gdy twój własny czas jako opiekunki lub opiekuna pewnego dnia się skończy, zostaw system, który jest spokojniejszy, jaśniejszy, bardziej zrozumiały, i bardziej godny zaufania niż ten, który przejąłeś.

Jeśli każde pokolenie to zrobi, COCO nigdy naprawdę się nie zestarzeje.
Ponieważ jego największym kapitałem nie będzie jego oprogramowanie.
Będzie nim dyscyplina inżynierska przenoszona przez ludzi, którzy dalej ją budują.
Dziękuję, że stałeś się jednym z nich.
Następny rozdział nie znajduje się już w tym podręczniku.
Następny rozdział znajduje się w kodzie, który zaraz napiszesz.

Podręcznik COCO

Bo oprogramowanie się rozwija.
Dobra architektura rozwija się wolniej.
A dobra filozofia powinna przetrwać obie.

softify.pro