Како да читате извештај за ревизија на VPN: обемот е поважен од значката
Значката за ревизија крие четири факти што вреди да се прочитаат: кои компоненти биле тестирани, која верзија, што било исклучено и кои поправки биле повторно тестирани.
Значките се евтини за прикажување и скапи за толкување. Објавен извештај за ревизија е ограничено парче инженерска работа: именуван оценувач испитал именувани компоненти, на именувана верзија, со наведен метод и временски буџет. Овие четири факти одредуваат што може да поддржи заклучокот, и тие обично се на првите неколку страници, а не во маркетинг резимето. Нивното читање трае десет минути и го спречува честиот пропуст да се прошири наод за клиентска апликација на цела услуга.
Што всушност ограничува делот за обем
Изјавата за обем е ограда, и сето надвор од неа останува без одговор, а не поминато. Извештаите ги наведуваат испитаните компоненти, опсегот на commit-и или идентификаторот на build, користеното опкружување и дозволениот модел на интеракција. Десктоп клиент, мобилна апликација, серверски код, backend на сметката и продукциска инфраструктура се пет различни предмети, и задачата може да опфати кое било нивно подмножество.
Исклучувањата се важни колку и вклучувањата, зашто се наведуваат намерно, а се читаат небрежно. Сметковен систем опишан како надвор од обем не се подразбира како безбеден, а мобилна апликација оставена надвор од задача едноставно не е испитана. Означете ја секоја нетестирана компонента во своите белешки како непозната и спротивставете се на нагонот празнината да ја пополните со репутација.
Два вида тестови одговараат на различни прашања
Прегледот на изворниот код и тестирањето во работа бараат различни дефекти. Рецензентот што чита код може да проследи изведување на клуч, да забележи отсутна проверка на должина и да расудува за цел парсер без да го изврши. Тестерот врз услуга што работи открива што всушност прави распоредениот build: сертификат што апликацијата го одбива, резервен протокол што е и понатаму овозможен, крајна точка што излегува верзиски банер преку конфигурација што никој не ја прегледал.
Ниту едното не го заменува другото, и извештајот обично наведува кое е извршено. Кога резимето вели «ревидирано» без таа разлика, двосмисленоста е во резимето, не во извештајот.
Ограничувањата на пристапот го прават истото. Задача со црна кутија не може да ја види серверската конфигурација, а преглед на архитектура што никогаш не допира распоредена крајна точка не може да забележи дека продукцијата се разликува од дијаграмот. И двете се легитимни; мешањето на нивните резултати не е.
Како наодот станува поправена верзија
Вредната половина од извештајот е табелата за отстранување: секој наод, неговата тежина според методот на оценувачот, одговорот на операторот и резултатот од повторното тестирање. Бројките за тежина доаѓаат од избрана методологија, а не од природата, затоа споредувајте тежини во еден извештај, а не меѓу два со различни скали.
Потоа поврзете ја поправката со објавен софтвер. Поправениот наод е важен за корисникот само кога верзијата што ја носи поправката е инсталираната, и затоа идентификаторот на build во извештајот и дневникот на промени на изданието мора да се читаат заедно. Повторното тестирање што ја опфатило поправката го затвора циклусот; нетестирана поправка е тврдење. Таква е и поправката испорачана само во гранка што ниедно стабилно издание не ја споило.
Што значката не може да ви каже
Отсуството на наоди не е доказ за отсуство на дефекти. Кратка задача со фиксен буџет ќе пропушти нешто, а чесното читање на чист извештај е дека оценувачот не ги нашол класите на проблеми што ги барал во достапното време.
Значката исто така не може да зборува за својства надвор од нејзиниот обем. Тврдењата за практиката на евидентирање, надлежноста или чувањето живеат во документ за политика, не во ревизија на клиентска апликација, и никаква репутација на оценувачот не преминува таа граница.
Евидентирање докази што можете да ги одбраните
Напишете го цитатот во три дела: компонентата, верзијата и потврдената поправка. Објавена задача како VPN ревизијата нарачана од Mozilla поддржува точно оние тврдења што ги опишува нејзиниот обем и ништо пошироко, што и понатаму вреди доста кога цитатот е прецизен. Истиот извештај цитиран за нешто што никогаш не го испитал вреди помалку од никаков цитат, зашто поканува доверба што никој не ја заработил.
Кога тврденото својство паѓа надвор од секој достапен извештај, оставете го нерешено во документот. Нерешената линија поканува дополнително прашање; значката не. Единствениот исклучок е својство што го решава друг, еднакво конкретен документ, и тогаш се менува цитатот, а не тврдењето.
Уште две навики го прават читањето трајно: забележете го датумот на извештајот наспроти изданието што навистина го извршувате, и чувајте ја разликата меѓу она што е тестирано и она што сте го распоредиле. Двете претвораат одлука за доверба во нешто што колегата може да го провери.