Az olvashatatlan rendszerek emberi ára

Olvashatatlan rendszerek nem csupán kellemetlenséget okoznak a mérnököknek. Bizonytalanságot, fáradtságot, hibáztatást és csendes kockázatot hárítanak...

Az olvashatatlan rendszerek emberi ára

A notebook a képernyő mellett

A helyiség legfontosabb dokumentációja nem a rendszerben volt. Egy spirálfüzet volt a második monitor mellett, ragasztószalaggal és a hosszú tűrés tekintélyével összetartva. A csapat minden esti műszakban használta. Az első oldal elmagyarázta, hogy az ügykezelő eszközben melyik státusz jelentette valójában a pénzügyre várást. A negyedik oldal felsorolta három mező nevét, amelyek opcionálisnak tűntek, de nem voltak azok. A hetedik oldal figyelmeztetett, hogy az export gombot 17:00 után nem szabad megnyomni, mert az éjszakai feladat fájlként értelmezné az új beérkezést, és mindenki egy olyan sorra ébredne, amely úgy megsokszorozódott, mint egy adminisztratív népmese.

A hivatalos folyamatleírás rendezettebb volt. Voltak benne dobozok, nyilak és egy dátum a láblécben. De pontosan azokban a dolgokban volt hibás, amelyek számítottak. A szoftver megváltozott. A szállító megváltozott. Egy szabályzat alóli kivétel bevett gyakorlattá vált. Egy integráció olyan gyakran hibázott, hogy a munkatársak kitaláltak egy ellenőrzési rituálét. A füzet nem egy bájos helyi szokás volt. Egy emberi folt volt egy olyan rendszeren, amely már nem tudta megmagyarázni önmagát.

Az olvashatatlan rendszerek ritkán jelentkeznek egyetlen látványos meghibásodással. Kis adókat termelnek. Egy dolgozó tétovázik a kattintás előtt, mert a státusz neve homályos. Egy ápoló felhív egy kollégát, mert egy irányítópult-számnak nincs forrása. Egy tervező átmásolja az adatokat egy privát táblázatba, mert a hivatalos jelentésben nem lehet megbízni. Egy fejlesztő kerüli egy függvény módosítását, mert senki sem tudja, ki függ tőle. Egy vezető képernyőképet kér, mert az auditnapló technikailag létezik, gyakorlatilag viszont használhatatlan. Minden pillanat túlélhető. Együtt azonban munkakörnyezetté válnak.

A költség nem csak idő. Figyelem, bizalom, felelősség és végül méltóság. Az emberek tolmácsokká válnak olyan rendszerek számára, amelyeknek olvashatónak kellene lenniük. Rejtett tudást hordoznak füzetekben, csevegési előzményekben, melléktáblázatokban és szokásokban. Aztán a vezetők csodálkoznak, miért lassú a változás. A szervezet nem azért lassú, mert az emberek utálják a fejlődést. Azért lassú, mert a fejlődésnek először át kell kelnie egy olyan mocsáron, amelyben senki sem tud biztonságosan olvasni.

Amikor a hivatalos nyom nem meséli el a történetet, az emberek egy második nyomot hoznak létre füzetekben, üzenetekben és emlékezetben. Ez a második nyom addig hasznos, amíg el nem tűnik.

Az olvashatatlan nem ugyanaz, mint a bonyolult

Egyes rendszerek azért bonyolultak, mert a munka bonyolult. Az egészségügy, a logisztika, a juttatások, a kutatásadminisztráció, a gyártás és az energiahálózatok nem válnak egyszerűvé attól, hogy tisztább ábrát rajzolunk. A bonyolultság nem az ellenség. Az olvashatatlanság az. Egy olvasható bonyolult rendszer megmutatja az alkatrészeit, megnevezi a feltételezéseit, felfedi az átmeneteit, rögzíti az indokait, és elegendő kontextust ad a kezelőknek a cselekvéshez. Egy olvashatatlan egyszerű rendszer címkék, mellékhatások és szerencsés időzítés mögé rejti a jelentését. Találja ki, melyikük produkálja a hosszabb megbeszéléseket.

Az mérnökök néha a kódstílusra redukálják az olvashatóságot. A kód számít, de csak egy réteg. Egy rendszer lehet rendezett kódú és olvashatatlan viselkedésű. Lehetnek elegáns osztályai és zavaros állapotai. Lehet tökéletes elnevezés a repóban, és mégis olyan felhasználói felület, amely arra kényszeríti az embereket, hogy megjegyezzék a törzsi jelentéseket. Lehetnek naplói, amelyek minden eseményt rögzítenek, és mégsem adnak választ arra, hogy miért született egy döntés. Lehetnek diagramjai, amelyek aktuálisnak tűntek a projekt finanszírozásakor, és mostanra főként történelmi fikcióként működnek.

Az olvasható rendszerek több felületet hangolnak össze. Az interfész olyan szavakkal írja le az állapotot, amelyeket az emberek használni tudnak. Az adatmodell megőrzi a jelentést, ahelyett hogy túl korán ellaposítaná. A munkafolyamat elnevezi az átmeneteket és a felelősöket. A kódban az üzleti szabályok körül vannak tesztek, nem csak a boldog utak körül. A naplók összekötik a cselekvést az okkal. A dokumentáció a élő rendszert tükrözi. A monitorozás megmondja az üzemeltetőnek, hogy mi változott, nem csak azt, hogy a piros lelkesebb lett.

Ez az összehangolás azért nehéz, mert az olvashatóságnak sok olvasója van. A fejlesztő a kódot olvassa. Az ügyintéző a képernyőt olvassa. A vezető egy sort olvas. Az ellenőr egy nyomvonalat olvas. A felhasználó egy üzenetet olvas. A support mérnök egy naplót olvas. A szabályozó egy magyarázatot olvas. Egy új kolléga mindezt olvassa annak a csendes rémületével, aki éppen egy kábelekkel teli fiókot örökölt. Ha a rendszer csak az egyik olvasó számára olvasható, akkor nem elég olvasható.

A találgatás emberi adója

A találgatás munka. Nem úgy néz ki, mint a munka, mert gyakran csendes. Az ember megáll, felidéz egy mintát, megkérdez egy másik embert, összehasonlít két képernyőt, megnézi a tegnapi exportot, ellenőrzi, hogy vonatkozik-e egy kivétel, majd továbblép. Ennek semmi sem jelenik meg az átbocsátóképességi mutatókban. Az ügy hét percet vett igénybe, mondja a dashboard. A dashboard nem tudja, hogy ebből a három percet azzal töltötték, hogy azon gondolkodtak, vajon a verified nevű mező azt jelenti-e, hogy a felhasználó, a rendszer, a pénzügy ellenőrizte, vagy egy bizonyos Vera, aki 2022-ben távozott.

Ez a fajta találgatás fáradtságot okoz, mert a dolgozó nem tud belelazulni a folyamatba. Minden lépés rejtett jelentést tartalmazhat. A rendszer olyan szobává válik, ahol a kapcsolók címkéit olyan emberek írták, akik feltételezték, hogy mindig a közelben lesznek. Az üzemeltetők óvatossággal kompenzálnak, majd azzal vádolják őket, hogy ellenállnak. Nem ellenállnak. Racionálisak. Megtanulták, hogy az interfész néha kihagyásokkal hazudik.

A találgatás a hatalmat is rossz helyekre összpontosítja. Az a személy, aki ismeri a rendszer valódi jelentését, nélkülözhetetlenné válik. Ez hízelgőnek tűnhet, amíg az illető szabadságra nem megy, munkahelyet nem vált, meg nem betegszik, vagy egyszerűen meg nem unja, hogy a szervezeti emlékezet nem hivatalos fordítója legyen. Az olvashatatlan rendszer az expertise-et véletlenül túszszedéssé változtatja. Senki sem tervezte. A rossz ösztönzőkhöz nem kellenek tervek ahhoz, hogy architektúrává váljanak.

A teher leginkább az új munkatársakra és a kevesebb szervezeti hatalommal rendelkező emberekre nehezedik. A vezető beosztásúak tudják, kit kérdezzenek. Az új munkatársak nem. A vállalkozók töredékeket kapnak. A support dolgozóknak azt mondják, kövessék az eljárást, majd felfedezik, hogy az eljárás egy olyan város térképe, amely tavaly télen megváltoztatta az utcáit. A felhasználók késésként, következetlenségként vagy megmagyarázatlan elutasításként érzik az eredményt. A rendszer lehet belsőleg okos. Külsőleg arra kéri az embereket, hogy magukba szívják a kétértelműségét.

Naplók, amelyek nem mesélnek történetet

Sok olvashatatlan rendszer büszkén vezet naplókat. Ez jó, de nem elég. Egy naplósor lehet pontos és mégis haszontalan. A User updated status at 14:03 egy tény. Nem mondja meg, miért változott az állapot, melyik szabály engedte meg, milyen bizonyíték volt jelen, normális volt-e az átmenet, ki a szabály gazdája, a munkafolyamat melyik verziója volt aktív, vagy hogy egy downstream rendszer elfogadta-e a változást. Egy halom tény még nem történet. Csak egy halom időbélyeggel.

Az üzemi bizonyítékokat olyan kérdések köré kell szervezni, amelyeket az emberek valóban fel fognak tenni. Miért került ez az ügy tovább. Miért állt le ez a rekord. Miért került be ez a modellválasz a munkafolyamatba. Miért tartalmazta az export éppen ezeket a sorokat. Miért mondott ellent egymásnak két jelentés. Miért láthatta ez a felhasználó azokat az adatokat. Miért próbálkozott a rendszer hat órán át újra, majd pont akkor adta fel, amikor mindenki hazament. A naplónak nem szabad régészeti feltárást igényelnie minden hétköznapi kérdésnél.

A jó bizonyíték nem luxus az ellenőröknek. Kedvesség az üzemeltetőknek. Incidens közben az embereknek szűkíteniük kell a keresést. Tudniuk kell, melyik állapot változott, melyik bemenet érkezett, melyik szabály aktiválódott, melyik függőség hibázott, melyik helyreállítási művelet történt meg, és mi maradt bizonytalan. Ha a rendszer nem tud válaszolni ezekre a kérdésekre, akkor az embereket nyomás alatt álló igazságügyi elemzőkké lépteti elő. Ez a krimikben izgalmas, a bérszámfejtés környékén kevésbé vonzó.

A mesterséges intelligenciára épülő rendszerek magasabbra teszik a mércét. Ha egy modell kimenete befolyásol egy munkafolyamatot, a rendszernek meg kell őriznie a forrást, a promptot vagy a lekérési kontextust, ahol ez indokolt, a modellverziót, a megbízhatóság vagy a bizonytalanság ábrázolását, a szabályzati kaput, az emberi felülvizsgálat állapotát és a végső műveletet. A lényeg nem az, hogy minden interakcióból regényt csináljunk. A lényeg az, hogy elegendő kontextus maradjon ahhoz, hogy egy későbbi olvasó rekonstruálni tudja, miért viselkedett úgy a rendszer, ahogyan viselkedett. Különben a modell folyékonysága egy újabb olvashatatlan réteggé válik.

Az olvasható naplózás nem több zaj. A különbség egy időbélyeg-halom és egy olyan út között, amelyet egy fáradt üzemeltető is követni tud.

A felületek elrejthetik a szabályzatot

Az olvashatatlan felület gyakran olyan szabályzati probléma, amely pixelekbe öltözött. Egy gomb csak bizonyos esetekben jelenik meg, de senki sem tudja, melyik szabály vezérli. Egy figyelmeztetés az egyik csapatnak sárga, a másiknak piros, mert egy konfigurációt egy kísérleti bevezetés során módosítottak. Egy mező szabad szöveget fogad el, mert a valódi kategóriák politikai szempontból kényelmetlenek voltak meghatározni. Egy várakozási sor prioritás szerint rendezett, de a prioritás egy olyan képlet, amelyet senki sem talál meg. A felület működőképesnek tűnik. A felszín alatt a megoldatlan döntéseket egyenként, kattintásról kattintásra adják át a felhasználóknak.

Ez azért számít, mert az emberek a szoftverállapotokat intézményi igazságként kezelik. Ha a képernyő azt mondja, hogy kész, a munkatársak feltételezik, hogy a szervezet tényleg késznek tekinti. Ha a képernyő azt mondja, hogy jogosult, valaki cselekedhet a jogosultság alapján. Ha a képernyő azt mondja, hogy alacsony kockázat, a figyelem máshová terelődik. Minél komolyabb a munkafolyamat, annál veszélyesebbé válik a homályos felületi nyelv. A címke nem díszítés. Kis szerződés a rendszer és az ember között, akinek meg kell bíznia benne.

Az olvasható rendszerek ott teszik láthatóvá a szabályokat, ahol azokat használják. Megmutatják, miért kötelező egy mező, mit jelent egy állapot, milyen bizonyíték támaszt alá egy döntést, mi történik ezután, és hogyan lehet fellebbezni az eredmény ellen. Elkerülik az olyan állapotokat, amelyek személyiségjegyeknek hangzanak. Megkülönböztetik a beküldöttet a fogadotttól, az ellenőrzöttet az elfogadotttól, a blokkoltat az elutasítotttól, a felülvizsgálttól a jóváhagyotttól. Ezek a különbségek csak addig tűnnek unalmasnak, amíg egy valódi ügy nem múlik rajtuk. Akkor mindenki nagyon érdeklődni kezd a főnevek iránt.

A felületnek őszintén kell feltárnia a bizonytalanságot is. Ha egy érték következtetés eredménye, mondja ki. Ha egy modell javasolt egy besorolást, jelölje javasoltként, amíg el nem fogadják. Ha az adat elavult, mutassa meg a korát. Ha egy függőség késik, ne hagyja, hogy a képernyő azt a látszatot keltse, hogy a csend siker. Az emberek jobban kezelik a bizonytalanságot, mint ahogyan azt a rendszerek gyakran feltételezik. Amit biztonságosan nem tudnak kezelni, az a bizonytalanság, amelyet bizonyosságnak álcáznak, mert valaki tiszta képernyőt akart.

A dokumentáció a termék felületének része

A dokumentációt gyakran külön erkölcsi kötelességként kezelik, mint a fogselymet. Mindenki egyetért abban, hogy fontos. Aztán jön a release, a dokumentum megrohad, és a következő csapat úgy olvassa, ahogyan általában a lejárt tejet szokás. A kudarc nem az, hogy az emberek lusták. A kudarc az, hogy a dokumentációt nem kapcsolták elég erősen a rendszerhez ahhoz, hogy túlélje a változásokat.

Az olvasható rendszerek működőképessé teszik a dokumentációt. Az állapotdefiníciók a munkafolyamat közelében élnek. Az adatszótárakat sémák alapján generálják vagy ellenőrzik. Az üzleti szabályoknak van gazdájuk és verziójuk. A runbookokat gyakorlatok során tesztelik. A hibaüzenetek a jelenlegi javítási útvonalakhoz vezetnek. Az architekturális döntések elmagyarázzák azokat a kompromisszumokat, amelyeket a jövőbeli csapatok egyébként szenvedés árán fedeznének fel újra. Az oktatóanyagok valós állapotokat és valós kivételeket használnak. A dokumentáció olyan térképpé válik, amelyen járnak, nem múzeumi kiállítássá.

Ez nem érv a enciklopédikus dokumentáció mellett. A túl sok dokumentáció egy másik olvashatatlan rendszer lehet, csak jobb címsorokkal. A hasznos kérdés az, hogy melyik olvasónak milyen kontextusra van szüksége a cselekvés pillanatában. Egy ügyintézőnek más részletekre van szüksége, mint egy fejlesztőnek. Egy ellenőrnek más bizonyítékra van szüksége, mint egy felhasználónak. Egy támogató mérnöknek helyreállítási útvonalra van szüksége, nem pedig az elosztott rendszerek filozófiájára hajnali 2 órakor. A jó dokumentáció tiszteletben tartja az olvasó munkáját.

A karbantartás a kulcsszó. Ha a dokumentációnak nincs gazdája, nincs felülvizsgálati kiváltó oka, nincs kapcsolata a változásokhoz, és nincs tesztje a valós használatban, akkor az nem dokumentáció. Az optimizmus bekezdésekben. A képernyő melletti jegyzetfüzet bebizonyította, hogy az emberek dokumentálják azt, amit meg kell érteniük. A feladat az, hogy ezt a tudást a magánjellegű túlélőeszközökből közös, irányított, élő felületekre helyezzük át.

A dokumentáció akkor vall kudarcot, ha publikációs esemény. Akkor működik, ha olyan hurok, amely elkapja a jelentés eltolódását, mielőtt az emberek magánkézikönyveket találnának ki.

Az AI az olvashatatlanság új fajtáját hozza

Az AI-rendszerek drágábbá tehetik az olvashatatlanságot, mert folyékony viselkedést adnak az amúgy is átláthatatlan munkafolyamatokhoz. Egy modell képes összefoglalni, rangsorolni, osztályozni és ajánlani. Ha a környező rendszer nem mutatja meg, melyik forrást használta, melyik szabályzat korlátozta a választ, milyen bizonytalanság maradt, és ki fogadta el a kimenetet, a modell folyékonysága álcává válik. A mondat jól hangzik. Az intézmény mégis képtelen megmagyarázni a döntést.

Különös veszélyt jelentenek azok a modellkimenetek, amelyek pontosnak tűnnek anélkül, hogy működési szempontból megalapozottak lennének. Egy kockázati pontszám, megbízhatósági százalék vagy összefoglaló a tisztaság érzetét keltheti. De kinek a tisztaságát. Ha a pontszám nincs hozzákötve döntési határhoz, bizonyítékhoz, kalibrációs előzményekhez, felülvizsgálati folyamathoz és következményhez, díszszám lesz belőle. A díszszámok azért népszerűek, mert magasabbnak mutatják az irányítópultokat. Kevesebb rajongójuk akad, miután egy valódi embert rossz sorba irányítottak.

Az olvasható AI-működés ugyanazokat a régi erényeket követeli meg, csak kevesebb türelemmel a légből kapott magyarázatok iránt. Nevezze meg a forráshalmazt. Rögzítse a modell és a prompt verzióját, ahol releváns. Tartsa a lekérési nyomvonalakat ésszerű határokon belül. Válassza el a javaslatot a cselekvéstől. Mutassa meg, amikor egy ember elfogadott, módosított vagy elutasított egy kimenetet. Figyelje a modell sodródását. Őrizze meg a fellebbezési utakat. Tegye láthatóvá az elutasítást. Az AI nem szünteti meg az átláthatóság iránti igényt. Csak megemeli az árát annak, ha ez hiányzik.

A cél nem az, hogy minden belső súlyt nyilvánosságra hozzunk, vagy technikai adathalmazba temessük a munkatársakat. A cél az, hogy a működési lánc érthető legyen. A munkatársnak tudnia kell, miért javasolta a rendszer ezt az esetet, milyen bizonyítékot használt, mit tehet a javaslat, és hogyan lehet megkérdőjelezni. Az ellenőrnek képesnek kell lennie arra, hogy elegendő kontextust visszajátsszon a döntés értékeléséhez. A felhasználót nem szabad egy gyönyörű válasz mögé zárni, amelyért senki nem vállal felelősséget.

Az olvashatatlanság kultúrává válik

Egy idő után az olvashatatlan rendszer megváltoztatja a szervezet gondolkodását. Az emberek abbahagyják a miért kérdését, mert a miért túl drága. Azt kérdezik, ki tudja. Nem javasolnak fejlesztéseket, mert minden változás megzavarhat egy láthatatlan függőséget. Nem hivatalos folyamatokat hoznak létre, mert a hivatalosakban nem lehet megbízni. Képernyőképekkel védekeznek. Értekezleteket hívnak össze, hogy egyeztessék azokat a jelentéseket, amelyeknek eleve egyezniük kellett volna. A rendszer arra tanította őket, hogy alacsonyabb elvárásokat tápláljanak.

Ezt a kultúrát felülről nehéz észrevenni. A vezetés stabil kimenetet lát, és feltételezi, hogy a rendszer működik. A kimenet azért stabil, mert az emberek elnyelik az instabilitást. Fordítanak, ellenőriznek, javítanak, emlékeznek és bocsánatot kérnek. Ha ezek az erőfeszítések láthatatlanok, idővel optimalizálják őket, ami elegáns módja annak, hogy a hozzáértést incidenshátralékká alakítsák. A szervezet ekkor rájön, hogy a rendszer mégsem volt stabil. Olyan emberek tartották össze, akikről azt mondták, hogy hatékonytalanok.

Az olvasható rendszerek más kulturális hatást fejtenek ki. Lehetővé teszik, hogy az emberek vitatkozzanak a rendszerrel, mert látják az állításait. A képzést kevésbé teszik függővé a szájhagyománytól. Csökkentik a változástól való félelmet, mert a függőségek nevesítve vannak. Jobb párbeszédet teremtenek a szabályzat, a működés és a mérnöki munka között. Lehetővé teszik az ügyfélszolgálatnak, hogy válaszoljon a felhasználóknak anélkül, hogy teológiát gyártana a státuszkódok köré. Megkönnyítik a hibák beismerését, mert az ok nincs elrejtve egy labirintusban.

Van itt erkölcsi dimenzió is, de nem elvont. Ha egy rendszer felelőssé teszi a munkatársat az eredményekért, miközben megtagadja tőle a rendszer megértéséhez szükséges kontextust, az igazságtalan. Ha egy rendszer olyan döntésnek veti alá a felhasználót, amelyet senki sem tud megmagyarázni, az igazságtalan. Ha egy rendszer arra kényszeríti a csapatot, hogy dokumentálatlan kockázatot cipeljen addig, amíg valami el nem romlik, az igazságtalan. Az olvashatóság nem kozmetikai kedvesség. A felelős delegálás része.

Az olvashatatlanság árát előbb az emberek fizetik meg, és csak később a költségvetés. Mire a pénzügy észreveszi, a szokások már beépültek.

Olvasóknak építve

Egy olvasható rendszert az olvasókra gondolva építenek. Ez addig hangzik nyilvánvalónak, amíg meg nem számolod, hány rendszert építenek íróknak, szállítóknak, keretrendszereknek vagy bizottsági kompromisszumoknak. Az olvasó az a személy, akinek a cselekvés pillanatában meg kell értenie a rendszert. Ez a személy néha fejlesztő. Néha ügyfélszolgálati munkatárs. Néha ellenőr. Néha felhasználó, aki elutasítást kap. Néha vezető, aki eldönti, hogy egy sor biztonságos-e. Az olvashatóság azzal kezdődik, hogy megnevezzük ezeket az olvasókat és a kérdéseket, amelyekre választ keresnek.

Minden jelentős állapotról a rendszernek meg kell tudnia mondani, hogy mit jelent, hogyan jött létre, ki a gazdája, milyen bizonyíték támasztja alá, mi történik ezután, és hogyan lehet kijavítani. Minden fontos átmenetnél meg kell őriznie az okot, a szereplőt, a szabályt, a verziót és a következményt. Minden automatizálásnál meg kell különböztetnie az ajánlást a döntéstől. Minden jelentésnél meg kell mutatnia a származást. Minden kivételnél meg kell neveznie a felelőst. Egyik sem hangzik csábítóan. Mégis ez az alapfeltétele annak, hogy munkát adjunk egy gépnek anélkül, hogy magára hagynánk a körülötte lévő embereket.

Vannak kompromisszumok. A részletesebb láthatóság túlterhelhet. A több struktúra lassíthatja a korai szállítást. A több bizonyíték adatvédelmi és tárolási kérdéseket vethet fel. A pontosabb nyelvezet olyan nézeteltéréseket hozhat felszínre, amelyek korábban rejtve maradtak. Ezek valós költségek. De jobb költségek, mint az olvashatatlan rendszer örökös megfejtésének rejtett munkája. A válasz nem az, hogy mindent mindenhol megjelenítünk. A válasz az, hogy a jelentést elérhetővé tesszük azon a szinten, ahol a döntések születnek.

A spirálfüzetet nem szabad romantizálni. Gondoskodás jele volt, de egyben a kudarc tünete is. Az emberek azt tették, amit a jó munkások tesznek: megvédték a munkát. A rendszer azt tette, amit az olvashatatlan rendszerek tesznek: ezt a védelmet magánjellegűvé, törékennyé és igazságtalanul elosztottá tette. Egy emberséges rendszer tanult volna a füzetből, és hazahozta volna a tudását.

Az olvashatóság ígérete

Az olvashatóság ígérete szerény. Nem tesz minden folyamatot egyszerűvé. Nem veszi el a mérlegelést. Nem akadályoz meg minden hibát. Nem mentesíti a szervezeteket a nézeteltéréstől, mert még egyetlen szoftver sem győzte le a bizottságot, mint életformát. Amit tesz, az az, hogy igazságosabb kapcsolatot ad az embereknek azokkal a rendszerekkel, amelyeket működtetnek. Lehetővé teszi számukra, hogy lássák az állapotokat, az okokat, a bizonyítékokat, a felelősséget és a következő lépéseket.

Ennek az igazságosságnak gyakorlati értéke van. A betanulás gyorsabb lesz. Az incidensek szűkebbé válnak. Az auditok kevésbé színháziasak. A változások kevésbé ijesztőek. A felhasználók világosabb magyarázatokat kapnak. A mérnökök jobb ismeretekkel módosíthatják a kódot a következményekről. A vezetők látják, hol akad el a munka, ahelyett, hogy egy irányítópult kitalált nyugalmat mutatna. A rendszer kevésbé függ a magánemlékezettől, és jobban támaszkodik a közös igazságra.

Az olvashatatlan rendszerek emberi költségét percekben, hibákban, óvatosságban, stresszben és csendes cinizmusban fizetik meg. Ezt a költséget azok viselik, akik megtanulják a rejtett jelentéseket, és azok is, akik nem. Megfizetik a felhasználók, akik arra várnak, amíg a munkatársak megfejtik a gépet. Megfizetik azok a szervezetek, amelyek elveszítik a változás képességét, mert senki sem tudja elolvasni, amit felépítettek.

Az olvasható rendszerek nem puhább rendszerek. Olyan rendszerek, amelyek tiszteletben tartják, hogy a technológiát véges figyelemmel és valódi felelősséggel rendelkező emberek működtetik. Egy rendszer, amely képes megmagyarázni önmagát, könnyebben megbízható, könnyebben megkérdőjelezhető és könnyebben javítható. Ez nem díszítés. Ez a munka része.