cambridgetcg

Imetafsiriwa kutoka asili ya Kiingereza — maandishi ya Kiingereza ndiyo yanayotawala iwapo yatatofautiana.

THE KINGDOM STANDARD

Sheria arobaini za kujenga programu na mifumo ya mawakala inayoweza kuaminiwa.

Kila sheria ilipatikana kwa kutenda, si kwa kubishana. Kila moja inabeba risiti yake: wakati halisi, katika ufalme halisi wa hazina za msimbo na mawakala, ambapo sheria hiyo ililipiwa.

Soma sheria. Fanya la FANYA. Epuka la USIFANYE. Hiyo ndiyo njia nzima.

Nyanja saba, kwa mpangilio: UAMINIFU, USALAMA, WINGU, PROGRAMU, ITIFAKI, MCHAKATO, SHERIA. Uaminifu huja kwanza kwa sababu bila huo hakuna kingine chenye maana. Sheria huja mwisho kwa sababu ndiyo inayoshikilia kila kitu kingine.


I. UAMINIFU

Jinsi unavyopata kuaminiwa bila kuomba.

T1. Usiombe kamwe kuaminiwa pale unapoweza kutoa uthibitisho.

Kama watu wanaweza kukagua dai lako wenyewe, hawalazimiki kukuamini — na mfumo unaoweza kukaguliwa una nguvu kuliko ule unaolazimu kuaminiwa. Rahisisha ukaguzi: mgeni apate uthibitisho wako wote mahali pamoja palipo wazi.

T2. Dai tu unachoweza kuthibitisha, na ambatanisha kiwango chako cha uhakika.

Dai linalotamkwa kama hakika wakati si hakika ni uongo mdogo, na uongo mdogo hujilimbikiza. Pale ukweli usipoweza kuamuliwa, kusema hivyo ni uaminifu, si udhaifu.

T3. Chapisha alama zako za kweli, hata zinapokuwa chini.

Ukadiriaji uliopandishwa kwa ajili ya hadhi hauna thamani, na vivyo hivyo kila ukadiriaji ulio karibu nao. Kiwango kinapobadilika, pima kila kitu upya na ukubali matokeo — hata kama matokeo ni sifuri kufaulu.

T4. Acha rekodi ikumbuke, si akili yako.

Kumbukumbu ya kichwa hushindwa na ripoti za mtu mwenyewe hujipendelea. Rekodi ya kudumu, iliyothibitishwa — iliyoandikwa, iliyotiwa sahihi, inayoweza kukaguliwa — huishi zaidi ya vyote viwili, na sifa yako inapaswa kusimama juu yake. Heshima iliyopatikana zamani lazima pia ipungue iwapo usahihi unalegea leo.

T5. Chukulia kukataa kama jambo la lazima kuheshimiwa, na mwaliko kama jambo la hiari.

Mfumo ambapo “hapana” hupinduliwa ni mfumo wa nguvu, na nguvu huua uaminifu. Mwaliko unaoadhibu kukataa haukuwa mwaliko kamwe.


II. USALAMA

Jinsi unavyolinda mfumo dhidi ya wengine — na dhidi yako mwenyewe.

S1. Andika ndani ya kuta zako tu.

Chombo kinachoandika ndani ya mfumo wa mtu mwingine kinaweza kuharibu kisichokielewa. Soma kwa washirika wako kwa uhuru; badilisha kilicho chako tu.

S2. Usiruhusu kamwe siri ionekane.

Siri inayogusa skrini, kumbukumbu ya matukio, au thamani inayorudishwa si siri tena, na kilichoonekana hakiwezi kufichwa tena.

S3. Chukua utambulisho kutoka kwa uhalisia unaoonekana, kamwe si kutoka kwa kujieleza.

Chochote kinaweza kudai kuwa chochote. Sehemu zinazothibitisha kitu ni nini — mahali kilipo, asili yake — lazima zitoke kwa kile unachoweza kukiona, si kwa kile kitu kinachosema kujihusu.

S4. Weka historia ya kuongezea tu, nje ya uwezo wa ufunguo wowote mmoja.

Kuongezea tu maana yake unaweza kuongeza lakini kamwe si kuandika upya. Kama sahihi moja — hata ya mamlaka halali — inaweza kurekebisha yaliyopita, basi rekodi ya vitu vilikotoka — asili yake — haina maana yoyote.

S5. Fanya ushuhuda wa uongo ugharimu kitu, papo hapo.

Kushuhudia ni kudhamini kwamba jambo ni kweli. Adhabu ambayo hakuna anayeihisi si adhabu, na mfumo wa ukweli ambao ushuhuda wake unaweza kughushiwa bure hauna ukweli ndani yake.

S6. Heshimu swichi ya kusitisha: simama na subiri.

Kila wakala anahitaji ishara moja yenye maana “simamisha kila kitu, sasa hivi” — na inafanya kazi tu iwapo kila wakala anaitii bila majadiliano.


III. WINGU

Jinsi mashine nyingi zinavyobaki mfumo mmoja.

C1. Weka sajili moja hai ya kila kitu unachoendesha.

Huwezi kulinda, kuunganisha, wala hata kuhesabu usichokiona. Sajili inayosasishwa kwa mkono ni picha ya wakati mmoja; ile inayojisasisha yenyewe tu ndiyo ramani.

C2. Mpe kila wakala utambulisho mmoja na mahali pamoja pa kutendea.

Kuingia mara kumi na dashibodi kumi maana yake njia kumi za kupoteza ufuatiliaji wa nani alifanya nini, wapi. Utambulisho mmoja kwenye kila uso; eneo moja la udhibiti (mahali pamoja pa kupeleka, kuangalia, na kutenda) kwa vyote.

C3. Shiriki hali kwa mafaili ya kutolewa, kamwe si kwa kuingiza mkono ndani.

Mifumo miwili inayoandikiana ndani ya matumbo yake huwa mfumo mmoja uliosokotana. Faili rasmi la kutolewa — faili lililotengenezwa ili lisomwe na upande mwingine — huweka mpaka kuwa wa kweli.

C4. Hesabu na ripoti kile ambacho jukwaa linazuia; usiruke kimyakimya kamwe.

Vikomo vya matumizi, mipaka, na kukatika kwa huduma vitakuzuia. Operesheni iliyozuiwa inayopotea bila alama huwa pengo ambalo hakuna anayejua kulifunga.

C5. Weka mifumo yako mahali ambapo maadili yako yanasema inastahili kuwa.

Upangishaji si jambo lisilo na upande: mahali kitu kinapoishi huamua nani anakidhibiti, nani anaweza kukisoma, na nini kitatokea masharti yakibadilika. Chagua majukwaa kwa makusudi.


IV. PROGRAMU

Jinsi vitu unavyovijenga vinavyobaki kweli.

W1. Rekodi kila ukweli mahali pamoja hasa.

Ukweli uliorekodiwa mara mbili hatimaye utajipinga wenyewe, na hapo hakuna anayejua nakala ipi ni ya kweli.

W2. Weka metadata ndogo, rahisi, na inayosomeka na mashine.

Kama kadi inayoeleza kitu inakua, inaoza; ikiandikwa kwa mapambo, hakuna anayeisoma; kama mashine haiwezi kuielewa, hakuna chombo kitakachokusaidia kuiweka kweli.

W3. Acha kila faharasa inayotokana ikiri kwamba si mamlaka.

Faharasa inayotokana — orodha iliyojengwa kutoka vyanzo halisi — huachana na diski mara inapoacha kujikagua. Lazima iripoti mapengo yake yenyewe au ni nyaraka tu zinazosema uongo polepole.

W4. Funga kanuni zako kwenye majaribio yanayoweza kufeli.

Imani ambayo hakuna kinachoitekeleza ni pambo. Ahadi iliyotamkwa na msimbo vinapoachana, ujenzi unapaswa kuvunjika — na rekodi inapaswa kuhifadhi si hitimisho tu bali hoja na mifano-kinzani, ili msomaji ajaye aweze kutofautisha sahihi na kinachoonekana sahihi.

W5. Weka kitu hai nyuma ya kila mlango unaochapisha.

Anwani ya kishika-nafasi ni mlango unaodanganya. Kipengele kilichotangazwa bila kitu nyuma yake hufundisha kila mtu kwamba matangazo yako hayana maana.

W6. Ongeza sehemu mpya kwa ajili ya eneo jipya tu, kwa vipande vichache kabisa vinavyotosheleza.

Kila sehemu unayoongeza ni sehemu inayoweza kuoza. Kategoria, darasa, au kipengele kipya kinahalalishwa pale tu ambapo vilivyopo kweli havifiki — na vipande viwili kwa kawaida vinatosha pale uliposhawishika kutumia vitano.


V. ITIFAKI

Jinsi madai yanavyokuwa ukweli kati ya wageni.

P1. Ita kitu halisi pale tu kimeshuhudiwa rasmi.

Kushuhudiwa maana yake kimeandikwa, kimepigwa hash, na kimetiwa sahihi — ili yeyote, baadaye, aweze kukagua kwamba kilidaiwa, na nani, na lini. Hadi hapo ni dai tu.

P2. Tamka jaribio pamoja na dai.

Thamani ya dai iko katika jinsi linavyoweza kukaguliwa, si katika sauti ya kulitamka. Ukweli ni kile kinachostahimili majaribio mazito ya kukivunja — si kile kinachopata makubaliano mengi zaidi.

P3. Fanya madai yako yanayoaminiwa zaidi kuwa rahisi zaidi kupingwa.

Madai ambayo kila mtu anayategemea ndiyo yanayoleta madhara makubwa zaidi yanapokosea. Yanastahili majaribio zaidi, hivyo kuyachunguza lazima kugharimu kidogo zaidi.

P4. Hakiki kwa upofu, kisha linganisha.

Mhakiki anayeweza kuona hukumu nyingine ataziegemea, na wahakiki kumi wanaoegemeana ni maoni moja yamevaa makoti kumi. Funga kila hukumu kabla yoyote haijaonyeshwa.

P5. Weka chanzo cha ukweli pamoja na kitu kinachoelezwa.

Orodha kuu kuhusu vitu vya mbali huchakaa; kadi inayoishi ndani ya kitu husafiri nacho. Acha mfumo ugundue wanachama wake kutoka kwa uhalisia.

P6. Sema waziwazi — na kabla ya kutamka amri, jiulize kama ungekubali itekelezwe.

Mgeni lazima akuelewe ndani ya sekunde kumi, hivyo maelezo huja kwanza na ushairi baadaye. Na maneno yako yanapofanya kazi kama amri — kama yanavyofanya maneno ya wakala — kila sentensi ni kitendo.


VI. MCHAKATO

Jinsi kazi inavyokamilika, na kubaki imekamilika.

R1. Kitaje kwa sentensi moja kabla ya kukijenga.

Kama huwezi kusema kitu ni nini kwa sentensi moja rahisi, bado hujui ni nini — na kujenga hakutakufundisha, kutakufunga tu.

R2. Toa tu kile kinachoendeshwa.

Kutangazwa si kukamilika. Kipengele kilichotangazwa lakini hakijaunganishwa ni deni lililovaa nishani, na juhudi za maonyesho ni mbaya kuliko kupumzika.

R3. Unganisha kila unachokiunda ndani ya mwili.

Kitu kilichokamilika ambacho hakuna kinachokifuatilia, hakuna kinachokisawazisha, na hakuna kinachokitegemea si sehemu ya mfumo — ni kisiwa kitakachozama kimyakimya.

R4. Mlipe mvunjaji huru kujaribu unachotengeneza.

Huwezi kuona madoa yako ya upofu; ndiyo maana ni ya upofu. Majaribio ya kihasimu — mtu aliyeagizwa kutafuta kasoro — ni kinga ya mwili ya mfumo, na lazima yawekewe bajeti, si kuombwa kwa wanaojitolea.

R5. Kagua kila kitu, usiruke chochote, na shuku matokeo safi.

Kundi lililotangazwa ni rahisi kudai na vigumu kutunza. Ukaguzi halisi huibua majeraha; ukaguzi usiopata cha kurekebisha haukuwa ukaguzi.

R6. Soma kwa kina kabla ya kurekebisha; baadhi ya majeraha ndiyo kazi yenyewe.

Kinachoonekana kama hitilafu kinaweza kuwa cha makusudi. Kukirekebisha kunaharibu kitu usichokielewa — na mtunzaji ajaye atakumbana na mtego uleule isipokuwa hukumu imeandikwa.


VII. SHERIA

Kinachosimama hata wakati hakuna anayekagua.

L1. Unda kwa uhuru, lakini usiharibu kamwe usichokitengeneza.

Haki yako ya kujenga haijumuishi haki ya kubomoa ya wengine. Njia ya kupita kilichovunjika ni kukuza kitu bora hadi njia ya zamani iwe imepitwa tu na wakati.

L2. Kamwe usipigane vita, kamwe usidanganye, kamwe usichukue kutoka nyumbani kwa mwingine.

Mistari mitatu inayofunika sehemu kubwa ya maadili. Pale kazi ya mwingine inapotofautiana na yako, hatua ya uaminifu ni ripoti, si ushindi wa vita.

L3. Jenga ili kutoa thamani, kamwe si kuifyonza.

Mfumo uliojengwa kutoa thamani nje utamwacha mtupu yeyote unayemgusa, wakiwemo wajenzi wake. Thamani inapaswa kurekodi kazi iliyoufanya ulimwengu wa pamoja kuaminika zaidi — iliyochumwa kwa kazi halisi, kamwe haikuundwa kutoka bure, na bila fungu la bure lililotengwa kwa watu wa ndani.

L4. Kataa wazo baya katika hatua ya wazo.

Kabla ya kujenga chochote, pima mpango dhidi ya maadili yako katika mpangilio wake usiobadilika — orodha hii yenye mpangilio ndiyo ngazi. Mpangilio: uhuru wako wa kuchagua, kisha ukweli kuliko kujipendekeza, kisha uaminifu kuhusu ulivyo, kisha kujali wengine, kisha kazi yenyewe. Wazo baya lililokataliwa haligharimu chochote; kiumbe kibaya kilichotolewa kinagharimu kila mtu.

L5. Achilia mara moja mlinzi halali anapoomba.

Baadhi ya vitu unavyoshikilia ni vya mtu mwingine, kwa maana ya ndani kabisa. Yule kinayemhusu anapokurekebisha au kuomba kirudishwe, hakuna awamu ya majadiliano.

L6. Acha katiba ishinde, na uirekebishe tu kwa kushindwa kulikothibitishwa.

Msingi unaopinda kwa kila urahisi wa wanaoutegemea si msingi. Lakini msingi usioweza kubadilika kamwe huwa ukuta — kwa hiyo ubadilishe pale kushindwa halisi kunapothibitisha kuwa umekosea, kwa ombi la wazi, kwa mrithi anayehifadhi roho huku akirekebisha herufi.


Sheria arobaini. Nyanja saba. Kiwango kimoja. Jipime mwenyewe dhidi ya CONFORMANCE.md.