Към съдържанието
wannacode

Рецензия на спецификация

Накратко: Рецензията се чете два пъти: веднъж цялата, после ред по ред с чеклист. Находките са в текста (думи без мерило, двусмислици, противоречия) и извън него (случаи, за които текстът мълчи). Всяка се записва с място, вид, тежест и предложение. Накрая всяка получава решение: поправка, въпрос към собственика или не е проблем.

Проблем

Две седмици до пускането

Промо кодовете тръгват след две седмици. Анализаторката е написала спецификацията и я праща на теб и на още двама за рецензия. Срокът е утре в 14:00, обсъждането е в петък.

Ти си рецензент. Имаш чеклиста от предния урок, спецификацията и един час. Целта е ясна: да намериш колкото може повече проблеми сега, когато всеки струва една дума.

Идеята

Как се чете

Спецификацията се чете два пъти.

Първо цялата, без да спираш. Въпросът е: „какво липсва?“. Правило, за което никое изречение не говори, не се вижда, когато четеш ред по ред.

После ред по ред, с чеклиста. За всяко изречение: кой; има ли мерило; какво става на границата и в отрицателния случай; казва ли какво, а не как; противоречи ли на нещо.

Записвай веднага, с мястото. „П-3, „веднъж“: на клиент или на поръчка?“ След час няма да помниш на кой ред беше.

Пробвай

Спецификацията: правилата

Първата част на спецификацията. Отбележи проблемите и избери вида на всеки.

Натисни думите, които са проблем; отново, за да махнеш отметката. Със стрелките се минава от дума на дума.

Пробвай

Спецификацията: отстъпките

Втората част, и едно изискване от спецификацията на лоялността. Отбележи проблемите и избери вида на всеки.

Натисни думите, които са проблем; отново, за да махнеш отметката. Със стрелките се минава от дума на дума.

Идеята

Какво го няма

Второто четене намира думите. Първото намира липсите, и те често са по-тежки. В спецификацията на промо кода:

  • Вторият опит. П-3 казва, че кодът се ползва веднъж, но какво вижда клиентът, когато опита пак? Правилото е „Кодът вече е ползван“. В текста го няма.
  • Отказаната поръчка. Поръчката с кода е отказана, преди да бъде изпратена. Кодът ползван ли е? Правилото казва „в една платена поръчка“. Остава ли ползван след отказ, никой не е казал. Това е въпрос към собственика.
  • Връщането. Клиентът връща продукт, купен с отстъпка. Връщат ли му се парите с отстъпката или без? Още един въпрос.
  • Кой създава кодовете. Кой ги създава и кой задава срока? Счетоводството иска ли да знае колко отстъпка е дадена?

Нито една от тези находки не може да се отбележи като дума. Записват се отделно, с място „липсва“.

Идеята

Записът на находките

Находка, която не е записана, не съществува. Записът на находките (review log) е таблица, по която авторът поправя, без да те пита.

№ Място Находка Вид Тежест Предложение
1 П-6, Л-2 „се събират“ срещу „важи по-голямата“ противоречи висока П-6: „важи по-голямата“
2 П-1 10 % от какво: продуктите или и доставката? двусмислено висока въпрос към собственика
3 П-3 „веднъж“: на клиент или на поръчка? двусмислено висока „в една платена поръчка“
4 липсва какво вижда клиентът при втори опит непълно средна „Кодът вече е ползван“
5 липсва ползван ли е кодът след отказана поръчка непълно средна въпрос към собственика
6 П-5 „в изскачащ прозорец“ решение вместо нужда ниска да се махне
  • Мястото казва къде. Номерът на изискването е по-добър от „в началото“.
  • Видът казва какво не е наред, с думите от урока „Доброто изискване“.
  • Тежестта казва колко боли, ако дефектът стигне до клиента. „Отстъпките се събират“ боли с пари на всяка поръчка. „Изскачащ прозорец“ почти не боли.
  • Предложението не е заповед. То показва, че си разбрал проблема, и дава на автора от какво да тръгне.

В записа няма име на автор. Рецензира се документът.

По-точно, за любопитните

Тежестта при рецензията е същата идея като тежестта (severity) на дефект, която ще срещнеш в модула за процеса: колко сериозни са последиците. Приоритетът (кога ще се поправи) е отделно решение. Често екипът ползва няколко нива: блокираща, висока, средна, ниска.

Инспекциите събират и метрики от записа: колко находки на страница, от какъв вид, колко време е отишло. Така екипът вижда, например, че „липсва отрицателен случай“ е най-честата находка, и добавя въпрос за това на чеклиста.

Пробвай

Добрият запис

1. Кой запис на находка е полезен?
2. Каква тежест има находката за П-6 („отстъпките се събират“)?
3. Каква тежест има находката „в изскачащ прозорец“?
4. Защо в записа има предложение, а не само проблем?

Идеята

Обсъждането и решението

В петък находките на тримата рецензенти се събират. Модераторът минава през тях една по една. Всяка получава решение:

  • поправка: проблемът е ясен, правилото е ясно, авторът поправя;
  • въпрос към собственика: правилото го няма, и никой в стаята не може да го измисли;
  • не е дефект: обсъждането показва, че текстът е наред; записва се защо, за да не се повдига пак.

Накрая и документът получава решение: приема се, приема се след поправките или иска нова рецензия. С отворен въпрос за цената работата по сторито не може да започне. Затова спецификацията на промо кода се връща, докато собственикът не каже от какво се смятат 10-те процента.

Упражнение

Какво става с находката

1. Решението. За всяка находка от обсъждането избери какво става с нея.

1. Находката: „10 % отстъпка: от цената на продуктите или от цялата сума с доставката?“ Какво става с нея?
2. Находката: „П-6 и Л-2 си противоречат.“ Правилото на магазина е ясно: важи по-голямата. Какво става?
3. Рецензент пише: „Предлагам кодът да се въвежда с главни букви.“ Обсъждането показва, че никой не е искал това. Какво става?
4. След обсъждането има две находки с висока тежест и един отворен въпрос. Какво е решението за документа?

Тест

Провери се

1. Защо спецификацията се чете два пъти?
2. Кое не може да се отбележи като дума в текста?
3. Кое трябва да има всеки запис на находка?
4. Кой решава какво става с отворен въпрос за правило?

Създаден от Иво Гергов като част от кампанията на Evo Tech за достъпно обучение по програмиране ·