1.7 Verkfræðistaðlar og undanþágur

Yfirlit og tilgangur

Verkfræðistaðall er skjalfest, samþykkt regla um hvernig vinna er unnin. Til dæmis: „allar þjónustur verða að bjóða upp á heilsuathugunarendapunkt“ eða „allar opinberar vefsíður verða að uppfylla WCAG (Web Content Accessibility Guidelines) 2.2, stig AA“. Staðall er ekki ábending og ekki bara venja. Hann er skuldbinding sem skipulagsheildin bindur sig við, helst skuldbinding sem þú getur athugað. Þessi kafli fjallar um allan lífsferil staðla, hvernig stór skipulagsheild semur, birtir, tekur upp, framfylgir og þróar þá, og, jafn mikilvægt, hvernig hún meðhöndlar tilvikin sem eiga lögmætt heima utan þeirra í gegnum stýrt undanþáguferli (einnig kallað afsalsferli): skjalfest, tímabundin heimild til að víkja frá staðli af tilgreindum ástæðum.

Tilgangurinn er sá að í stórum stíl hætta óformleg viðmið að virka. Þegar fimm verkfræðingar deila einu herbergi ferðast „hvernig við gerum hlutina hér“ með samtölum og af sjálfu sér. Þegar fimm þúsund verkfræðingar spanna tugi teyma, þrjú tímabelti og áratug af starfsmannaveltu sundrast sú þögla þekking í hundruð ósamrýmanlegra staðbundinna venja. Staðlar eru hvernig þú skrifar hart áunnar lexíur niður einu sinni, svo hvert teymi erfir þær í stað þess að læra hverja í gegnum eigið rekstrarrof. Þeir draga úr vitrænni byrði, gera kóðarýni að efnislegri frekar en stílbundinni, leyfa fólki að flytja milli teyma og gefa endurskoðendum og eftirlitsaðilum eitthvað áþreifanlegt til að meta.

En staðlar bera sinn eigin bilunarhátt: stífleika. Staðall sem viðurkennir engar undantekningar mun fyrr eða síðar hindra lögmæta vinnu: tilraunaverkefni, skorðu frá söluaðila, raunverulega nýtt tilvik sem höfundarnir ímynduðu sér aldrei. Teymi stöðvast þá annaðhvort eða, verra, hunsa staðalinn hljóðlega, sem tærir trúverðugleika allra staðla. Lækningin er gamla máltækið „undantekningin sannar regluna“. Sýnilegt, grundvallað undanþáguferli er það sem heldur stöðlum bæði trúverðugum og mannúðlegum. Þessi kafli byggir á ákvarðanatöku og stjórnarháttum (kafli 1.5) og ákvörðunarskrám (kafli 1.6) og nærir beint kóðunarstaðla og stíl (kafli 2.1), gátlista (kafli 12.2) og sniðmát (kafli 12.3).

Meginreglur

Staðall segir til um útkomu og gefur ástæðu. Regla ásamt rökum. Án hvers vegna geta menn ekki dæmt hvenær hún á raunverulega við.
Ef ekki er hægt að athuga hann er hann ekki enn staðall. Kjóstu prófanlegar fullyrðingar fram yfir væntingar.
Staðlar eru lifandi skjöl. Þeir eru útgáfustýrðir, eignaðir, dagsettir og endurskoðaðir, ekki höggnir í stein og yfirgefnir.
Sjálfvirknivæddu framfylgd þar sem þú getur. Taktu frá mannlega rýni fyrir dómgreind. Vélar athuga hið vélræna. Fólk athugar hið merkingarbæra.
Frávik eru væntanleg, ekki skammarleg, en þau verða að vera sýnileg. Heiðarlegt afsal slær hljóðlátt brot í hvert skipti.
Tímamarkaðu hverja undanþágu. Varanleg undanþága er galli í staðlinum. Dragðu hana fram og lagaðu staðalinn.
Orð og dæmi fram yfir hrognamál og skipanir. Fólk fylgir stöðlum sem það skilur og getur afritað frá.

Ráðleggingar

Skrifaðu staðla sem eru skýrir, prófanlegir og rökstuddir

Góður staðall er stutt, sjálfstætt skjal með fyrirsjáanlega lögun svo lesendur viti hvar þeir eiga að leita. Taktu upp eitt staðlasniðmát (kafli 12.3) og notaðu það alls staðar. Nauðsynlegir hlutar eru:

Titill og auðkenni: stöðugt heiti og tilvísunarnúmer til tilvitnunar.
Staða: drög, virkur, leystur af hólmi eða lagður niður, með dagsetningu.
Reglan: sett fram sem útkoma, skýrt og ótvírætt („verður“, „ætti“, „má“, notað af ásetningi, samkvæmt RFC 2119 venjum fyrir kröfulykilorð).
Rök: hvers vegna þessi regla er til. Kostnaðurinn eða áhættan sem hún kemur í veg fyrir.
Dæmi: samræmt dæmi og ósamræmt. Áþreifanlegt slær óhlutbundið.
Hvernig hann er athugaður: sjálfvirka prófið, lint-reglan eða rýniskrefið sem staðfestir hann.
Eigandi og rýnidagsetning: hver viðheldur honum og hvenær hann er næst endurskoðaður.

Rökin og „hvernig hann er athugaður“ eru það sem aðgreinir raunverulegan staðal frá ósk. Ef þú getur ekki sagt hvers vegna regla er til skaltu efast um hvort hún ætti að vera það. Ef þú getur ekki sagt hvernig fylgni er staðfest verður reglunni beitt ósamræmt og hún mætt gremju.

Paraðu hvern staðal við gátlista um góða starfshætti

Staðlar skilgreina áfangastaðinn. Gátlisti um góða starfshætti, stuttur, raðaður listi áþreifanlegra skrefa eða atriða til að staðfesta, hjálpar fólki að komast þangað og leyfir því að sannreyna sjálft áður en rýni fer fram. Handbækur verkfræði hjá hinu opinbera nota þetta mynstur mikið. NHS Wales og Digital Health and Care Wales (DHCW) birta verkfræðistaðla með hagnýtum gátlistum, og UK Government Digital Service (GDS) parar Service Standard og Technology Code of Practice við framkvæmanlega leiðsögn Service Manual. Gátlistinn er staðallinn gerður nothæfur: „Hefurðu bætt við aðgengisúttekt? Hefurðu prófað með skjálesara? Hefurðu náð yfir leiðsögn með lyklaborði eingöngu?“ Sjá kafla 12.2 fyrir gátlistamynstrið í heild.

Birtu staðla þar sem fólk vinnur nú þegar og hafðu þá finnanlega

Geymdu staðla í útgáfustýringu (hugbúnaðarsafni) sem Markdown, birt á leitanlegri innri vefsíðu, svo þeir fái sögu, rýni gegnum sameiningarbeiðnir og mismunargreiningu ókeypis, sömu rök og fyrir ákvörðunarskrár (kafli 1.6). Ein skrá, eitt sniðmát, einn leitarreitur. Að draga fram skiptir jafn miklu máli og geymslan. Tengdu viðeigandi staðal úr sniðmáti sameiningarbeiðnar, villuskilaboðum lint-tólsins og grind þjónustunnar, svo rétta reglan birtist á augnabliki vinnunnar en ekki í möppu sem enginn heimsækir.

Framfylgdu fyrst með sjálfvirkni, síðan með mannlegri rýni

Það eru tvær leiðir til að framfylgja staðli og þroskaðar skipulagsheildir nota hvort tveggja af ásetningi:

Sjálfvirk framfylgd: lint-tól, sniðmótarar, kyrrstæð greining, stefna sem kóði (til dæmis Open Policy Agent (OPA)), hlið í samfelldri samþættingu (CI) og arkitektúrhæfnisföll (sjálfvirk próf sem fullyrða að hönnunareiginleiki haldi enn). Sjálfvirkni er samræmd, þreytulaus, tafarlaus og óumdeilanleg, sem gerir hana tilvalda fyrir hinn vélræna meirihluta staðla (snið, nafngiftir, ósjálfstæðisreglur, nauðsynleg lýsigögn).
Mannleg rýni: kóðarýni, arkitektúrrýnistjórnir og öryggisrýni, tekin frá fyrir það sem vélar geta ekki dæmt: hvort ágrip er traust, hvort málamiðlun er skynsamleg, hvort ásetningur staðals er uppfylltur þótt bókstafur hans sé óþægilegur.

Þumalputtareglan: sjálfvirknivæddu hið athugunarhæfa og eyddu af skornum skammti mannlegri athygli í dómgreind. Sérhver staðall sem þú getur fært úr rýni í CI losar rýna til að gera hugsunina sem aðeins þeir geta.

Stýrðu fráviki með skjalfestu undanþágu-/afsalsferli

Enginn staðall passar í hvert tilvik, svo hannaðu neyðarútganginn af ásetningi. Gott undanþáguferli tilgreinir:

Hver getur veitt afsal: nefnt, ábyrgt vald í réttu hlutfalli við áhættuna (tæknilegur leiðtogi fyrir áhættulítið stílfrávik; arkitektúr- eða öryggisstjórn fyrir afsal öryggisvarnar). Þetta tengist beint stjórnarháttalíkani kafla 1.5.
Hvað þarf að skrá: staðalinn sem vikið er frá, sértæku ástæðuna, umfangið, bætandi eftirlit eða mildun og áhættuna sem er samþykkt. Fangaðu þetta sem ákvörðunarskrá (kafli 1.6) svo rökin varðveitist.
Skyldubundin fyrningardagsetning: sérhvert afsal er tímamarkað með skýrum lokadegi. Þetta er mikilvægasta einstaka reglan: hún kemur í veg fyrir að tímabundin undanþága verði hljóðlega að varanlegri stefnu.
Reglubundin rýni: eigandi rýnir opin afsöl á takti og annaðhvort endurnýjar þau með nýjum rökum, lokar þeim þegar vinnan er samræmd eða, ef sama undanþága kemur ítrekað fram, lítur á það sem sönnun þess að staðallinn sjálfur sé rangur og endurskoðar hann.

Þetta síðasta atriði er hjarta „undantekningin sannar regluna“. Stöðugur straumur afsala gegn einum staðli er ekki agabrestur. Hann er gögn. Hann segir þér að staðallinn sé rangt stilltur og lagfæringin er að þróa staðalinn, ekki að halda áfram að veita undanþágur.

Líttu á staðla sem lifandi skjöl með skýru eignarhaldi

Gefðu hverjum staðli eiganda (hlutverk, ekki bara einstakling) sem ber ábyrgð á að halda honum í gildi og rýnitakti (að minnsta kosti árlega). Veittu léttan farveg fyrir hvern sem er til að leggja til breytingu gegnum sameiningarbeiðni eða RFC (beiðni um umsögn), skriflega tillögu sem er send til endurgjafar áður en hún er tekin upp. Útgáfustýrðu staðla, leggðu þá niður með skýrum hætti og tilkynntu breytingar. Staðlaskrá sem er aldrei endurskoðuð rotnar í þjóðsögur sem fólk vitnar í sértækt og treystir lítið.

Málamiðlanir: kostir og gallar

Val	Kostir	Gallar
Margir ítarlegir staðlar	Samræmi, auðveld móttaka, úttektarhæft	Stífleiki, viðhaldsbyrði, getur farið fram úr framkvæmd
Fáir almennir staðlar	Sveigjanlegt, lítið viðhald	Ósamræmi, meiri endurdeilur fyrir hvert teymi
Sjálfvirk framfylgd	Samræmd, tafarlaus, þreytulaus, skalanleg	Kostnaður fyrirfram, rangar jákvæðar niðurstöður, blind á ásetning
Framfylgd með mannlegri rýni	Dæmir ásetning og blæbrigði	Hæg, ósamræmd, flöskuháls í stórum stíl
Strangt, engar undantekningar	Einföld skilaboð, ekkert til að spila með	Hindrar lögmæta vinnu, knýr hljóðlát brot
Stýrt undanþáguferli	Heldur stöðlum trúverðugum og mannúðlegum	Krefst stjórnarhátta, skráa og eftirfylgni

Meginspennan er samræmi gegn sveigjanleika. Staðall er til að fjarlægja frávik. Undanþáguferli er til að viðurkenna frávikin sem eru raunverulega réttlætanleg. Hallaðu of langt í stífleika og fólk fer fram hjá stöðlunum þínum. Hallaðu of langt í slökun og staðlarnir þýða ekkert. Undanþáguferlið er þrýstiventillinn sem leyfir þér að halda fastri línu og vera heiðarlegur um raunveruleikann.

Spurningar til að ræða með teyminu

Hversu margir staðlar eru réttur fjöldi fyrir þína stærð og rekur þínir í átt að stífleika eða ósamræmi? Skráin sjálf er málamiðlun: margir ítarlegir staðlar kaupa samræmi, auðvelda móttöku og úttektarhæfi á kostnað stífleika og viðhaldsbyrði, á meðan fáir almennir staðlar haldast sveigjanlegir en leyfa hverju teymi að deila aftur um sömu spurningar. Fyrir stórt fyrirtæki eða opinbera stofnun fer réttu stærðin eftir því hve mikið frávik þú getur raunverulega þolað á móti því hve mikið endurskoðendur þínir og móttaka þín þurfa að hafa negld niður. Komdu með gögn: hve marga virka staðla þú hefur, hve margir voru rýndir síðasta árið og hve oft teymi deila aftur um hluti sem staðall gat útkljáð. Skrá sem fer fram úr framkvæmd verður að þjóðsögum og sú sem er of þunn ýtir kostnaði á hvert teymi. Ákveddu af ásetningi hvað verðskuldar staðal og snyrtu þá sem ekki lengur vinna fyrir sér.
Hvar stenst bókstafur staðals sjálfkrafa á meðan ásetningur hans er hljóðlega brotinn, og hvernig muntu grípa það? Sjálfvirkni er samræmd, þreytulaus og blind á ásetning, sem þýðir að lint-tól eða stefnuathugun getur orðið græn á meðan raunverulega markmiðið (traust ágrip, skynsamleg málamiðlun, raunverulega aðgengileg síða) er misst. Þumalputtareglan er að sjálfvirknivæða hið athugunarhæfa og eyða af skornum skammti mannlegri rýni í dómgreind, og erfiði hlutinn er að koma sér saman um hvaða staðlar hafa ásetning sem ekkert CI-hlið getur fullyrt. Komdu með dæmi: staðla sem fólk uppfyllir bókstaflega á meðan það sigrar tilganginn, svo sem heilsuathugunarendapunkt sem tilkynnir heilbrigði á meðan þjónustan er biluð, eða kóða sem stenst sniðmótarann en hylur merkingu. Í eftirlitsskyldu umhverfi skiptir ásetningur mestu fyrir öryggis- og varnir, þar sem grænn hakreitur getur falið raunverulega áhættu. Ákveddu hvaða staðlar halda mannlegum rýni sérstaklega til að dæma ásetning og orðaðu þá staðla um útkomuna svo bæði vél og rýnir miði á sama markmið.
Hver á endurgjafarlykkjuna frá afsali til staðals, og á hvaða tímapunkti neyðir endurtekin undanþága þig til að breyta reglunni? Stöðugur straumur afsala gegn einum staðli eru gögn, ekki agaleysi, og merkið fer til spillis nema einhver sé ábyrgur fyrir að lesa það og bregðast við. Sjónarmiðið á móti er að endurskoðun staðals er raunveruleg vinna, svo það er áfram auðveldara að stimpla afsöl en að laga rangt stilltu regluna undir þeim. Komdu með tölurnar: hvaða staðlar skapa flestar undanþágur, hvort afsöl eru í raun tímamörkuð og rýnd á takti og hve mörg urðu hljóðlega varanleg. Fyrir öryggis- og varnarkritíska staðla í fyrirtækjum og hinu opinbera verður afsal að skrá bætandi eftirlit, mildun, áhættuna sem er samþykkt og harða fyrningu, annars verður tímabundið frávik að óskjalfestri stefnu sem birtist í næstu úttekt. Úthlutaðu eiganda til að rýna opin afsöl, settu þröskuld þar sem endurteknar undanþágur kalla fram endurskoðun staðals og líttu á varanlega undanþágu sem galla í staðlinum sem ber að laga.
Birtist réttur staðall á augnabliki vinnunnar, eða býr hann í möppu sem enginn opnar? Staðall sem enginn finnur er framfylgt af tilviljun, og í stórum stíl er flest brot ekki þrjóska heldur fáfræði: verkfræðingur vissi aldrei að reglan væri til eða fann hana ekki þegar það skipti máli. Sjónarmiðið á móti er fyrirhöfn, því að draga staðal fram í sniðmáti sameiningarbeiðnar, villuskilaboðum lint-tólsins og grind þjónustunnar kostar raunverulega samþættingarvinnu sem ein miðlæg vefsíða krefst ekki. Komdu með gögn um finnanleika: hvernig verkfræðingar finna staðla í raun í dag, hvort nýr starfsmaður getur fundið aðgengis- eða öryggisregluna sem stýrir verkefni hans á innan við mínútu og hve oft rýnar vitna í staðal sem höfundurinn hafði einfaldlega ekki séð. Fyrir stórt fyrirtæki eða opinbera stofnun spyrja endurskoðendur æ oftar ekki aðeins hvort staðall sé til heldur hvort hann hafi verið kynntur og aðgengilegur á ákvörðunarstundu, svo líttu á framdrátt sem hluta af staðlinum, ekki eftiráhugsun, og mældu hvort fólk nær til reglunnar þegar það þarf á henni að halda.
Hver á hvern virkan staðal, hvenær var hann síðast rýndur og hvernig myndirðu koma auga á þá sem hafa hljóðlega rotnað í þjóðsögur? Staðlar úreldast hljóðlega: regla skrifuð fyrir þremur árum fyrir ramma sem þú notar ekki lengur situr enn í skránni, vitnað í sértækt og lítið treyst, og dregur niður trúverðugleika staðlanna sem eru enn réttir. Fyrir stóra skipulagsheild er eignarhaldskostnaðurinn rýnitaktur sjálfur, sem finnst eins og yfirbygging þar til rekstrarrof eða úttekt afhjúpar staðal sem passar ekki lengur við raunveruleikann. Komdu með tölurnar í umræðuna: hve margir staðlar hafa nefndan eiganda (hlutverk, ekki bara farinn einstakling), hve margir voru rýndir síðasta árið, hve margir eru formlega lagðir niður á móti bara úreltir og hverjum er oftast og sjaldnast vitnað í. Í fyrirtækja- og opinberu samhengi ætlast endurskoðandi til að sérhver staðall sé útgáfustýrður, dagsettur og sýnilega í gildi, svo komdu þér saman um lágmarksrýnitakt, úthlutaðu sérhverjum staðli ábyrgum eiganda og leggðu niður þá sem vinna ekki lengur fyrir sér áður en þeir grafa undan trausti á hina.
Er valdið til að veita afsal í raun í réttu hlutfalli við áhættu staðalsins sem er afsalað? Stílfrávik og öryggisvarnarfrávik eru ekki sama ákvörðunin, en samt senda margar skipulagsheildir hvort tveggja annaðhvort til þungrar stjórnar (sem stöðvar lögmæta vinnu) eða láta bæði renna í gegnum einn tæknilegan leiðtoga (sem leyfir alvarlega áhættu að vera samþykkta af einhverjum án umboðs til þess). Spennan er hraði gegn ábyrgð: of mikill samþykkisnúningur knýr hljóðlát brot, en of lítill þýðir að afdrifarík frávik eru veifuð í gegn í spjallþræði. Komdu með kort af stöðlum þínum að samþykktaraðilum þeirra, auk úrtaks af nýlega veittum afsölum, og athugaðu hvort einhver hafi afsalað öryggis- eða varnarkritískri vörn án samsvarandi stjórnar, bætandi eftirlits, mildunar og skráðs áhættusamþykkis. Fyrir fyrirtæki og hið opinbera er þetta spurning um aðskilnað starfa sem eftirlitsaðilar skoða beint, svo tengdu hvern flokk staðla við nefnt vald í réttu hlutfalli við áhættu hans og tryggðu að sá sem samþykkir áhættu sé raunverulega ábyrgur fyrir afleiðingunum.

Sjónarhorn eftir geirum

Sprotafyrirtæki. Hafðu skrána pínulitla: skrifaðu aðeins niður handfylli reglna sem fjarvera myndi raunverulega skaða þig, svo sem stillingu sniðmótara, kröfu um heilsuathugun og síður sem hægt er að rata um með lyklaborði, og framfylgdu hverri með lint-tóli eða CI-athugun frekar en rýnifundi. Slepptu afsalsstjórninni alveg. Dagsett TODO í kóðanum og einnar línu athugasemd í sameiningarbeiðninni er fullkomlega góð tímamörkuð undanþága í þessari stærð. Af skornum skammti auðlind þín er verkfræðiathygli, svo standastu freistinguna að semja staðla fyrir vandamál sem þú hefur ekki enn.

Lítið fyrirtæki. Án sérstaks staðlaeiganda og með þröngt fjárhagsáætlun skaltu kaupa staðlana þína frekar en smíða: taktu upp birtar grunnlínur eins og UK GDS Service Standard, OWASP öryggisleiðbeiningar eða ráðlagðar lint-reglur rammans þíns, og hallaðu þér að athugunum sem þegar eru innbyggðar í verkfærin þín og hýst CI. Haltu einni stuttri síðu af staðbundnum reglum fyrir fáu hlutina sem eru raunverulega sértækir fyrir þig. Hver sem leiðir verkfræði veitir og skráir undanþágur í miðanum, með fyrningardagsetningu, svo jafnvel létt ferli haldist heiðarlegt.

Stórfyrirtæki. Verkefnið er stjórnarhættir yfir mörg teymi: ein skrá, eitt sniðmát, rök og dæmi fyrir hvern staðal og stefna sem kóði sem lætur leiðsluna mistakast fyrir vélræna meirihlutann. Rektu afsalsferli þar sem samþykktarvald er í réttu hlutfalli við áhættu, tímamarkaðu hverja undanþágu, rýndu opin afsöl á takti og grafðu í endurtekin afsöl sem merki um að staðall þurfi að breytast. Mældu hlutfall staðla sem framfylgt er sjálfvirkt og magn og aldur opinna afsala, og skilaðu hvoru tveggja til stjórnarháttastarfseminnar svo staðlar haldist stýrt kerfi en ekki kirkjugarður.

Hið opinbera. Birtu verkfræðistaðla þína opinskátt í hefð DHCW og GDS og paraðu hvern við gátlista sem teymi klára fyrir þjónustumat, svo regluvarsla sé sýnileg almenningi og eftirlitsaðilum. Gerðu nefndan æðri ábyrgðaraðila að valdinu fyrir afdrifarík afsöl og krefstu þess að sérhver undanþága skrái tiltekna viðmiðið, bætandi eftirlit eða tímabundna mildun, úrbótaáætlun og harða fyrningu. Innkaupa- og gagnsæisreglur þýða að bæði staðlar þínir og frávik verða hluti af opinberri skrá, svo líttu á úttektarhæfi og rekjanleika sem hönnunarkröfur frá upphafi.

Dæmi

Sprotafyrirtæki. Sjö manna sprotafyrirtæki heldur nákvæmlega þremur skriflegum stöðlum (sameiginleg stilling sniðmótara, krafa um heilsuathugunarendapunkt og „allar opinberar síður verða að vera ratanlegar með lyklaborði“), hver framfylgt með lint-tóli eða CI-athugun frekar en rýnifundi. Þegar einn verkfræðingur þarf að afhenda einnota frumgerð sem brýtur heilsuathugunarregluna er engin afsalsstjórn: hún skilur eftir dagsett TODO í kóðanum og einnar línu athugasemd í sameiningarbeiðninni um hvers vegna og hvenær hún lagar það. Það er tímamörkuð undanþága í mælikvarða sprotafyrirtækis, heiðarleg og sýnileg án ferlisyfirbyggingar. Athuganirnar þrjár borga fyrir sig með því að halda kóðarýni um efni en ekki stíl.

Stórfyrirtæki. Alþjóðlegur banki heldur innri verkfræðihandbók með um fjörutíu virkum stöðlum, hver í einu sniðmáti með rökum, dæmum og tengdum gátlista um góða starfshætti. Um 70% er framfylgt sjálfvirkt: snið, ósjálfstæðisstefna, nauðsynleg þjónustulýsigögn og öryggisvarnir kóðuð sem stefna sem kóði sem lætur CI-leiðsluna mistakast. Greiðsluteymi þarf að afhenda á gagnagrunni sem styður ekki enn lögboðinn dulkóðunareiginleika. Frekar en að hindra útgáfuna leggur það fram afsal sem nefnir staðalinn, bætandi eftirlitið (dulkóðun á forritalagi, encryption) og 90 daga fyrningu. Öryggisstjórnin veitir það og skráir. Níutíu dögum síðar finnur rýnin að vettvangurinn styður nú eiginleikann innbyggt og afsalinu er lokað. Staðallinn hélt, vinnan var afhent og fráviksins er fullkomlega hægt að rekja fyrir næstu úttekt.

Hið opinbera. Landsbundin heilbrigðisstofnun sem fylgir DHCW- og GDS-aðferðinni birtir verkfræðistaðla sína opinskátt, hvern paraðan við gátlista sem teymi klára fyrir þjónustumat. Aðgengi að WCAG 2.2 AA er harður staðall, framfylgt með sjálfvirkri úttekt í CI auk handvirks mats. Gamalt klínískt kerfi getur ekki strax uppfyllt eitt aðgengisviðmið án þess að stofna sjúklingaöryggiskritískri virkni í hættu. Teymið biður um tímamarkaða undanþágu. Nefndur æðri ábyrgðaraðili veitir hana og skráir tiltekna viðmiðið, tímabundna mildun (aðstoðaraðgangssíma), úrbótaáætlun og sex mánaða fyrningu, og skapar nákvæmlega þá rekjanlegu, rýnanlegu sönnun sem eftirlitsaðilar krefjast (kaflar 4.6, 10.4).

Viðskiptarök: hvatar, ávöxtun fjárfestingar og heildarkostnaður

Staðall kostar tímann til að skrifa hann, sjálfvirknivæða athugun hans og viðhalda honum. Ávöxtunin er greidd í hvert sinn sem athugunin keyrir og í hvert sinn sem verkfræðingur þarf ekki að stoppa og deila um útkljáða spurningu. Staðlar breyta endurteknum, dreifðum ákvörðunarkostnaði í einskiptis höfundarkostnað, sama hagfræði og ákvörðunarskrár (kafli 1.6), magnaður því staðall stýrir þúsundum framtíðartilvika, ekki einu liðnu vali.

Hvað varðar heildareignarkostnað (TCO), fullan líftímakostnað við að smíða, reka og viðhalda kerfi, lækka staðlar stærstu kostnaðarliðina: móttöku (nýir starfsmenn erfa samræmi í stað þess að rekja það afturábak), viðhald (einsleitur kóði er ódýrari að breyta) og tryggingu (úttektir eru ódýrari þegar regluvarsla er vélathugunarhæf og frávik eru þegar skjalfest). Undanþáguferlið ver þá ávöxtun gegn aðalógn hennar: stöðlum sem hnigna í hunsaðar þjóðsögur. Trúverðugt afsalsferli heldur stöðlum traustum, og traustir staðlar eru þeir sem fólk raunverulega fylgir. Kostnaðurinn við að sleppa þessu öllu er ósýnilegur á hverju mælaborði. Hann birtist sem hæg móttaka, ósamræmd gæði og úttektarniðurstöður, og safnast upp með hverju nýju teymi og hverri brottför.

Andmynstur og gildrur

Reglur án raka: staðall sem enginn skilur er staðall sem enginn getur beitt rétt eða véfengt heiðarlega.
Væntingastaðlar sem ekki er hægt að athuga: „kóði ætti að vera viðhaldanlegur“ er gildi, ekki staðall. Ekki er hægt að framfylgja honum eða andmæla.
Ekkert undanþáguferli: neyðir fram falskt val milli þess að hindra lögmæta vinnu og að umbera hljóðlát brot.
Varanlegar undanþágur: afsöl án fyrningar sem verða hljóðlega að raunverulegri, óskjalfestri stefnu.
Afsöl án skráa: frávik veitt á göngum eða í spjallþræði, ósýnileg næstu úttekt og næsta verkfræðingi.
Að hunsa merkið: að veita sömu undanþáguna ítrekað í stað þess að lesa hana sem sönnun þess að staðallinn þurfi að breytast.
Framfylgd með nöldri: að treysta á rýna til að grípa það sem lint-tól ætti að gera og sóa dómgreind á hið vélræna.
Staðlakirkjugarður: skrá skrifuð einu sinni, í eigu enginn, aldrei rýnd, vitnað í sértækt, treyst af fáum.
Hrognamálshliðvarsla: staðlar skrifaðir fyrir höfunda sína frekar en lesendur, án dæma til að afrita.

Þroskalíkan

Stig 1 (Upphaf): Staðlar eru ættbálkaþekking í höfðum eldri verkfræðinga, beitt viðbragðsdrifið. Framfylgd er ad hoc kóðarýninöldur. Frávik eru ósýnileg. „Hvernig við gerum það“ er mismunandi eftir teymi og eftir því hver rýndi breytinguna.
Stig 2 (Þróun): Sumir staðlar eru skrifaðir niður, í ósamræmdum sniðum og dreifðum stöðum, og upptaka er mjög breytileg milli teyma. Framfylgd er aðallega handvirk. Undanþágur gerast óformlega, án skráa eða fyrningardagsetninga.
Stig 3 (Stöðlun): Ein skrá, eitt sniðmát, rök og dæmi fyrir hvern staðal og gátlistar um góða starfshætti, beitt samræmt milli teyma. Sjálfvirk framfylgd fyrir vélræna meirihlutann. Skjalfest undanþáguferli með nefndum samþykkjendum, skráðum rökum og tímamörkuðum afsölum.
Stig 4 (Stjórnun): Staðlakerfið er mælt gegn grunnlínum. Þú fylgist með hlutfalli staðla sem framfylgt er sjálfvirkt á móti með mannlegri rýni, afsalamagni á staðal, tíma til lokunar og hve mörg afsöl fyrndust meðan þau voru enn opin, og skilar þessu til stjórnarháttastarfseminnar. Samþykktarvald er í réttu hlutfalli við áhættu og endurskoðað. Rýnitaktur og fyrning er framfylgt á grundvelli gagna frekar en velvilja. Staðall þar sem afsalshlutfall fer yfir samþykktan þröskuld er merktur til endurskoðunar.
Stig 5 (Samhæfing): Staðlar eru dregnir fram á augnabliki vinnunnar og framfylgt með stefnu sem kóða og hæfnisföllum. Afsöl eru grafin sem merki svo endurteknar undanþágur knýja staðla stöðugt til að þróast, og skráin er endurjöfnuð eftir því sem starfshættir breytast. Staðlar, gátlistar og afsöl eru eitt aðlögunarhæft, lifandi kerfi samþætt móttöku, afhendingu og úttekt.

Hugmyndir til umræðu

Hverja af stöðlum þínum geturðu sett fram með prófanlegri reglu og skýrum rökum, og hverjir eru í raun bara væntingar?
Hve stór hluti staðla þinna er framfylgt sjálfvirkt á móti því að rýnir taki eftir? Hvað þyrfti til að færa tíu í viðbót í CI?
Hvar gerast frávik í dag og myndirðu yfirleitt vita það? Eru þau skráð og tímamörkuð, eða hljóðlát?
Hver má veita afsal gegn öryggis- eða varnarkritískasta staðlinum þínum og er það vald í réttu hlutfalli við áhættuna?
Líttu á staðalinn með flest afsöl. Er það agavandamál, eða er staðallinn einfaldlega rangur?
Hvenær var hver virkur staðall síðast rýndur og hver á hann? Hverjir hafa hljóðlega orðið að þjóðsögum?

Helstu atriði

Verkfræðistaðall er regla sett fram sem útkoma, með rökum, dæmum og leið til að athuga hana: ef ekki er hægt að athuga hana er hún ekki enn staðall.
Paraðu hvern staðal við gátlista um góða starfshætti svo fólk geti sannreynt sjálft, eftir handbókamynstri hins opinbera (NHS Wales / DHCW, UK GDS).
Geymdu staðla í útgáfustýringu, haltu þeim lifandi með nefndum eigendum og rýnidagsetningum og dragðu þá fram á augnabliki vinnunnar.
Sjálfvirknivæddu hið athugunarhæfa með lint-tólum, stefnu sem kóða og hæfnisföllum. Taktu frá mannlega rýni fyrir dómgreind.
Stýrðu fráviki með skjalfestu, tímamörkuðu undanþágu-/afsalsferli: nefndur samþykkjandi, skráð rök, skyldubundin fyrning, reglubundin rýni.
Endurtekin undanþága er merki um að laga staðalinn, ekki bara að halda áfram að veita afsöl: „undantekningin sannar regluna“. Sjá kafla 1.5 (stjórnarhættir), 1.6 (ákvörðunarskrár), 2.1 (kóðunarstaðlar), 12.2 (gátlistar) og 12.3 (sniðmát).

Heimildir og frekari lestur

UK Government Digital Service, Government Service Standard, Technology Code of Practice, and GOV.UK Service Manual.
NHS Digital / NHS England, Service Standard and engineering guidance.
Digital Health and Care Wales (DHCW) / NHS Wales, published engineering standards and good-practice checklists.
Scott Bradner, RFC 2119: Key Words for Use in RFCs to Indicate Requirement Levels (IETF, 1997).
World Wide Web Consortium (W3C), Web Content Accessibility Guidelines (WCAG) 2.2.
Neal Ford, Rebecca Parsons, and Patrick Kua, Building Evolutionary Architectures (fitness functions as automated governance).
Torin Sandall et al., Open Policy Agent documentation (policy-as-code).
GitLab, The GitLab Handbook: a public example of living, version-controlled organizational standards.
Google, Software Engineering at Google (Winters, Manshreck, Wright): standards, readability, and automated enforcement at scale.
Atul Gawande, The Checklist Manifesto: the case for checklists as professional practice.