![Page 2: Ревью проектных документов – борьба за качество](https://reader031.vdocuments.site/reader031/viewer/2022020218/55a5f2fc1a28abdd3d8b46e8/html5/thumbnails/2.jpg)
Определения
• Ревью – собирательное название процесса, основное содержание которого заключается в анализе текста документов
• Проверяется корректность, непротиворечивость, полноту, ясность, проверяемость и другие критерии качества документа. Критерии качества определяются заранее и известны всем участникам
• Другое название ревью - статическое тестирование
• Ревью выполняется до передачи документа «на согласование» Заказчику
![Page 3: Ревью проектных документов – борьба за качество](https://reader031.vdocuments.site/reader031/viewer/2022020218/55a5f2fc1a28abdd3d8b46e8/html5/thumbnails/3.jpg)
Определения
• Известные варианты
• 1981 IBM, M. Fagan, IBM – best practice
• SEI CMM отдельная KPA “Peer Review”
• Варианты ревью:
• Peer Review - ревью членами проектной команды, постоянно включенными в проект: аналитиками, архитекторами, тестировщиками.
• Контрольный проход на совещании –проводится с участием членов продуктовой команды или членов других
• Инспекция приглашенным специалистом
• Согласование – ревью на завершающей стадии разработки документа, в котором участвуют члены проектной команды
![Page 4: Ревью проектных документов – борьба за качество](https://reader031.vdocuments.site/reader031/viewer/2022020218/55a5f2fc1a28abdd3d8b46e8/html5/thumbnails/4.jpg)
Зачем нужно и что дает хорошее ревью?
• Автору документа
• Менеджеру проекта
• Команде проекта
• Компании
• Заказчику
Автору:1. Снижение re-work (переделок документа)2. Уверенность в том, что нет явных недостатков3. Защищенность в случае обнаружения ошибок4. Опыт написания «правильных» документов
Менеджеру проекта:1. Снижение re-work на фазе тестирования 2. Снижение риска непопадания в бюджет3. Увеличение вероятности выполнения в срок4. Увеличение вероятности получить премию
Команде проекта:1. Понятные для всех документы, ускоренное
согласование2. Повышение командного духа3. Улучшение коммуникаций
Компании:1. Увеличение вероятности успешного проекта
Заказчику:1. Понятные документы2. Ускоренное согласование3. Повышение вероятности успешного проекта
Руководителю:1. Контроль качества2. Контроль за процессом3. Обучение на ошибках
![Page 5: Ревью проектных документов – борьба за качество](https://reader031.vdocuments.site/reader031/viewer/2022020218/55a5f2fc1a28abdd3d8b46e8/html5/thumbnails/5.jpg)
Кандидаты в ревьюеры
Артефакт
Аналитики
Потребители требований
Партнеры по взаимодействию
Авторы требований
![Page 6: Ревью проектных документов – борьба за качество](https://reader031.vdocuments.site/reader031/viewer/2022020218/55a5f2fc1a28abdd3d8b46e8/html5/thumbnails/6.jpg)
Что проверяем?
•Бизнес-цели
•Здравый смысл
•Изложение требований
•Оформление документа
![Page 7: Ревью проектных документов – борьба за качество](https://reader031.vdocuments.site/reader031/viewer/2022020218/55a5f2fc1a28abdd3d8b46e8/html5/thumbnails/7.jpg)
√ Бизнес-цели
•Все ли стейкхолдерывключены?
•Решены ли бизнес-цели проекта?
•Совпадают ли цели проекта с бизнес-целями?
![Page 8: Ревью проектных документов – борьба за качество](https://reader031.vdocuments.site/reader031/viewer/2022020218/55a5f2fc1a28abdd3d8b46e8/html5/thumbnails/8.jpg)
√ Здравый смысл
•Понятен ли скоп проекта, имеет ли он смысл?
•Есть описания as и to be?
•Бизнес-требования описаны в терминах бизнеса?
•Не смешаны ли бизнес-требования и функциональные требования?
![Page 9: Ревью проектных документов – борьба за качество](https://reader031.vdocuments.site/reader031/viewer/2022020218/55a5f2fc1a28abdd3d8b46e8/html5/thumbnails/9.jpg)
√ Изложение требований
•Ясность
•Непротиворечивость
•Отношение к скопу проекта
•Тестируемость
•Стиль
![Page 10: Ревью проектных документов – борьба за качество](https://reader031.vdocuments.site/reader031/viewer/2022020218/55a5f2fc1a28abdd3d8b46e8/html5/thumbnails/10.jpg)
√ Оформление документа
•Схемы и таблицы пронумерованы
•Использован актуальный шаблон документа
•Единые стили по всему документу
•Исправлены орфографические ошибки
![Page 11: Ревью проектных документов – борьба за качество](https://reader031.vdocuments.site/reader031/viewer/2022020218/55a5f2fc1a28abdd3d8b46e8/html5/thumbnails/11.jpg)
Инструментарий ревьюера –личный опыт
•Чек-лист (+ баллы)
•Управление процессом разработки артефактов в JIRA
•Заметки на полях
•Автогенерация списка открытых вопросов
![Page 12: Ревью проектных документов – борьба за качество](https://reader031.vdocuments.site/reader031/viewer/2022020218/55a5f2fc1a28abdd3d8b46e8/html5/thumbnails/12.jpg)
Чек-лист
№ Область проверки Формулировка проверки (ожидаемый результат)
Тип несоответствияВозможные значения:1 - критичное2 - серьезное3 - незначительное
Дата проведения проверки 1
(заполняется значениями поля "Проверка пройдена?")
1Наименование файла с документом
В названии файла указан тип разрабатываемого документа, номер BRD, бизнес-название
1
2Структура документа Структура документа должна соответствовать шаблону ЧТЗ принятому на проекте и\или используемому в департаменте Неофлекса. Шаблон ЧТЗ - <дать ссылку на шаблон ЧТЗ в SVN>
1
3Структура документа Структура документа содержит обязательные разделы из шаблона проектного документа
1
![Page 13: Ревью проектных документов – борьба за качество](https://reader031.vdocuments.site/reader031/viewer/2022020218/55a5f2fc1a28abdd3d8b46e8/html5/thumbnails/13.jpg)
Управление в JIRAАвтор
• Разработать и разместить документ в репозитории
• Перевести запрос в состояние «On Review», указать «Вид ревью» и имя сотрудника в роли «Руководитель Ревьюеров»
• Заполнить поле «Ревьюер(ы)» именами коллег-участников Peer Review («пиров»)
• Назначить последовательно запрос на всех «пиров». Указать в комментариях разделы документа для анализа.
DOC2.0«Пиры»
Проанализировать, внести замечания в документ, разместить документ в репозитории («в стопочку»), списать трудозатраты на задачу разработки документа
Автор
Уточнить замечания, перевести запрос в состояние «Reviewed»
Исправить замечания, создать/обновить «Протокол ревью», разместить в репозитории
Перевести запрос в состояние «Resolved»,
![Page 14: Ревью проектных документов – борьба за качество](https://reader031.vdocuments.site/reader031/viewer/2022020218/55a5f2fc1a28abdd3d8b46e8/html5/thumbnails/14.jpg)
Заметки на полях
![Page 15: Ревью проектных документов – борьба за качество](https://reader031.vdocuments.site/reader031/viewer/2022020218/55a5f2fc1a28abdd3d8b46e8/html5/thumbnails/15.jpg)
Список открытых вопросов
Текст с примечанием Автор
примечания
Раздел Примечание Дата
примечания
Статус Комментарий автора
документа
Критичность
Платежный документ С. Захаров 1.3. Платежный документ - юридически значимый документ
установленного формата, которым оформляются
банковские операции (платежи, переводы, взимание
комиссий и т.п.)
12.03.2014 Closed Исправлено Замечание
Массив проводок платежного
документа
С. Захаров 1.3. Массив проводок платежного документа - совокупность
бухгалтерских проводок, предназначенных для
бухгалтерского учета (отражения на балансе банка)
исполнения операции, регламентированной платежным
документом.
12.03.2014 Closed Исправлено Замечание
![Page 16: Ревью проектных документов – борьба за качество](https://reader031.vdocuments.site/reader031/viewer/2022020218/55a5f2fc1a28abdd3d8b46e8/html5/thumbnails/16.jpg)
Проблемы ревью
•Сложно «продать»
•Низкое качество ревью
•Сложно контролировать
•Ложные ожидания
![Page 17: Ревью проектных документов – борьба за качество](https://reader031.vdocuments.site/reader031/viewer/2022020218/55a5f2fc1a28abdd3d8b46e8/html5/thumbnails/17.jpg)
Решение проблем ревью
Как «продать» ревью
•Найдем сильного союзника
•Постоянный внутренний пиар и обучение
•Проведем соревнование
Как обеспечить качество ревью
•Правильные ревьюеры
•Правильное время
•Чеклист
•Аудит ревью
![Page 18: Ревью проектных документов – борьба за качество](https://reader031.vdocuments.site/reader031/viewer/2022020218/55a5f2fc1a28abdd3d8b46e8/html5/thumbnails/18.jpg)
Решение проблем ревью
Как контролировать
•JIRA
•Отчеты
•Протоколы
Управление ожиданиями
•Ошибки все равно останутся
•За документ отвечает автор
![Page 19: Ревью проектных документов – борьба за качество](https://reader031.vdocuments.site/reader031/viewer/2022020218/55a5f2fc1a28abdd3d8b46e8/html5/thumbnails/19.jpg)
Полезные ссылкиKarl Wiegers Webinar «5 Steps to Better Requirements Peer Reviews»http://www.batimes.com/business-analyst-training/public-description-lead.html?Event_ID=WID00093
Rebecca Burgess «Use and profit from peer reviews of requirement documents»http://www.batimes.com/articles/bad-ass-ba-peer-review.-part-1.html
http://www.batimes.com/articles/bad-ass-ba-peer-review.-part-2.html
http://www.batimes.com/articles/bad-ass-ba-peer-review.-part-3.html
http://www.batimes.com/articles/bad-ass-ba-peer-review.-part-4.html
Леонид Новиков «Rational Unified Process - как достичь 3-го уровня CMM»http://www.interface.ru/home.asp?artId=2312