Kako brati revizijsko poročilo o VPN: obseg je pomembnejši od značke

Značke je poceni prikazati in drago razlagati. Objavljeno revizijsko poročilo je omejen kos inženirskega dela: imenovani ocenjevalec je pregledal imenovane komponente, na imenovani različici, z navedeno metodo in časovnim proračunom. Ta štiri dejstva določajo, kaj lahko sklep podpre, in običajno so na prvih straneh, ne v marketinškem povzetku. Njihovo branje traja deset minut in prepreči pogosto napako razširiti ugotovitev o odjemalski aplikaciji na celotno storitev.

Kaj oddelek o obsegu zares omejuje

Izjava o obsegu je ograja in vse zunaj nje ostane brez odgovora, ne pa opravljeno. Poročila naštejejo pregledane komponente, obseg commitov ali identifikator gradnje, uporabljeno okolje in dovoljeni model interakcije. Namizni odjemalec, mobilna aplikacija, strežniška koda, zaledje računa in produkcijska infrastruktura je pet različnih predmetov, naloga pa lahko pokrije katero koli njihovo podmnožico.

Izključitve štejejo toliko kot vključitve, ker so navedene namenoma in prebrane neprevidno. Sistem računov, opisan kot izven obsega, ni sam po sebi varen, mobilna aplikacija, izpuščena iz naloge, pa preprosto ni pregledana. Vsako netestirano komponento v svojih zapiskih označite kot neznano in se uprite skušnjavi, da bi vrzel zapolnili z ugledom.

Dve vrsti preizkusa odgovarjata na različna vprašanja

Pregled izvorne kode in preizkušanje med delovanjem iščeta različne okvare. Pregledovalec, ki bere kodo, lahko sledi izpeljavi ključa, opazi manjkajoče preverjanje dolžine in razmišlja o celem razčlenjevalniku, ne da bi ga zagnal. Preizkuševalec na delujoči storitvi odkrije, kaj nameščena gradnja v resnici počne: potrdilo, ki ga aplikacija zavrne, še vedno omogočen rezervni protokol, končna točka, ki uhaja pasico različice skozi konfiguracijo, ki je nihče ni pregledal.

Nobeno ne nadomesti drugega in poročilo običajno navede, katero je bilo izvedeno. Ko povzetek reče »revidirano« brez te razlike, je dvoumnost v povzetku, ne v poročilu.

Omejitve dostopa delajo isto. Naloga črne škatle ne vidi konfiguracije strežnika in pregled arhitekture, ki se nikoli ne dotakne nameščene končne točke, ne more opaziti, da se produkcija razlikuje od diagrama. Oba sta legitimna; mešanje njunih rezultatov ni.

Kako ugotovitev postane popravljena različica

Vredna polovica poročila je tabela odprave: vsaka ugotovitev, njena resnost po metodi ocenjevalca, odziv upravljavca in izid ponovnega preizkusa. Številke resnosti izhajajo iz izbrane metodologije in ne iz narave, zato primerjajte resnosti znotraj enega poročila, ne med dvema z različnimi lestvicami.

Nato povežite popravek z izdano programsko opremo. Popravljena ugotovitev je za uporabnika pomembna šele, ko je nameščena različica, ki nosi popravek, zato je treba identifikator gradnje iz poročila in dnevnik sprememb izdaje brati skupaj. Ponovni preizkus, ki je pokril popravek, zapre zanko; netestiran popravek je trditev. Enako velja za popravek, izdan le v veji, ki je nobena stabilna izdaja ni nikoli združila.

Česa vam značka ne more povedati

Odsotnost ugotovitev ni dokaz odsotnosti napak. Kratka naloga s fiksnim proračunom bo kaj spregledala in pošteno branje čistega poročila je, da ocenjevalec ni našel razredov težav, ki jih je iskal, v razpoložljivem času.

Značka tudi ne more govoriti o lastnostih zunaj svojega obsega. Trditve o praksi beleženja, jurisdikciji ali hrambi živijo v dokumentu politik, ne v reviziji odjemalske aplikacije, in noben ugled ocenjevalca ne prestopi te meje.

Zapisovanje dokazov, ki jih lahko branite

Napišite navedek v treh delih: komponenta, različica in potrjeni popravek. Objavljena naloga, kot je revizija VPN, ki jo je naročila Mozilla podpira natanko tiste trditve, ki jih opisuje njen obseg, in nič širšega, kar je ob natančnem navedku še vedno precej vredno. Isto poročilo, navedeno za nekaj, česar ni nikoli pregledalo, je vredno manj kot noben navedek, ker vabi k zaupanju, ki si ga nihče ni prislužil.

Ko trdna lastnost pade zunaj vsakega razpoložljivega poročila, jo pustite v dokumentu nerazrešeno. Nerazrešena vrstica vabi k nadaljnjemu vprašanju; značka ne. Edina izjema je lastnost, ki jo razreši drug, enako konkreten dokument, in takrat se spremeni navedek, ne trditev.

Še dve navadi naredita branje trajno: zabeležite datum poročila glede na izdajo, ki jo zares izvajate, in ohranite razliko med tem, kar je bilo testirano, in tem, kar ste namestili. Oboje spremeni odločitev o zaupanju v nekaj, kar lahko sodelavec preveri.