Что делать, если нет документации



Создание ПО без требований к нему – невозможно. В конечном итоге это будет не выгодно ни заказчику, ни команде разработке и проект развалится.

Однако под «документацией» не всегда подразумеваются требования к ПО, это также могут быть тестовые артефакты – тесты, тест-кейсы, чек-листы. Общее состояние документации на проекте может быть разным.

Актуальная документация

Ситуация идеальная. В таких проектах отличные процессы разработки. Скорей всего процессы достаточно жесткие – нужно постоянно актуализировать требования и тесты.

В первую очередь нужно ознакомиться с документацией по требованиям, а затем прогнать все тесты (тест-кейсы, чек-листы), чтобы познакомиться с ПО.

Попав в такой проект нужно не потерять хватку и продолжать хорошие традиции. Не смотря на кажущуюся жесткость и бюрократичность процессов, в таких проектах понятно направление процесса разработки, как сейчас должно функционировать ПО и по каким тестам его проверять.

Не актуальная документация

Неактуальные требования и тестовые артефакты

Требования являются не актуальными, если после их согласования с заказчиком появилось множество изменений, которые не фиксировались ни в документах проекта, ни в тестовых артефактах.

Что делать: не отчаиваться. Сперва нужно изучить ПО с которым будете работать. Для этого нужно изучить имеющуюся документацию по требованиям. Тестовые артефакты тоже можно посмотреть, но в полглаза. Сильно на них рассчитывать не стоит. По имеющейся документации нужно составить карту ПО: какие разделы есть в ПО, какую функцию они выполняют. 

Вооружившись картой ПО нужно исследовать реальное ПО, фиксируя разногласия с документацией и непонятные места в ПО. В такой работе стоит отключить перфекциониста. Цель - понять как работает ПО и почему. После нанесения на карту основных “точек” - вопросов, которые нужно прояснить, нужно выдвигаться на охоту. Охотиться нужно за владельцем информации в лице разработчиков. 

Получить ответы у разработчиков может быть не просто. Будьте терпеливы и настойчивы. 

Завершив исследование нужно составить документ со списком спорной функциональности. Каждый пункт списка должен быть аргументирован: почему данная функциональность “подозрительная”, возможно она противоречит какой-то логике приложения или не удобна для конечного пользователя.

Далее нужно браться за актуализацию тестовых артефактов. Перед тем как броситься в омут работы оцените ее объем и выберете нужные вашему проекту артефакты: тест-кейсы или чек-листы.

Все описанные выше работы по объему зависят от проекта. Если у нас какое-то мобильное приложение, то все перечисленное может уложиться по времени в пару дней. Если проект продолжительный и большой по объему, то восстановление актуальности документации может занять несколько месяцев.

Неактуальные требования и актуальные тестовые артефакты

Ситуация удивительная, но вполне реальная. Попав в такой проект, смело идите выполнять тесты (тест-кейсы, чек-листы). Нужно найти в команде человека, который сможет отвечать на ваши вопросы относительно ПО. Тесты разрабатывают люди, и не всегда может быть понятна логика того или иного теста. Если “хранитель знаний” найдется, то это намного облегчит вам работу. Если такого человека нет, то пора одевать шляпу исследователя и изучать ПО.

Тут, как и в проектах с “идеальной” документацией, не стоит терять заложенные традиции и всеми силами поддерживать тестовые артефакты.

Актуальные требования и неактуальные тестовые артефакты

В первую очередь знакомимся с документацией по требованиям. По ним изучаем и исследуем проект. После чего приводим в актуальное состояние тестовые артефакты.

Полное отсутствие документации

Если в проекте нет никакой документации, то сразу надеваем шляпу исследователя и идем изучать ПО. Сформировав мнение о возможностях ПО, и составив список вопросов, отправляемся на охоту за знаниями. Сперва нужно опросить разработчиков и руководителя проекта, если они не смогут ответить на вопросы по какому-то разделу ПО, то правильность реализации нужно уточнять у заказчика.

Самое тяжелое это когда проект длится несколько лет и никто не заботится о ведении документации проекта. Восстанавливать актуальность тяжело, но необходимо. Память человека ограничена. Никогда не надейтесь на память - записывайте!


Дата добавления: 2018-08-06; просмотров: 613; Мы поможем в написании вашей работы!

Поделиться с друзьями:






Мы поможем в написании ваших работ!