Управление разработкой и документирование

Тема 9

1. Планирование разработки

Управление разработкой начинается с превращения цели проекта в план: декомпозиция работ на задачи, оценка их длительности и последовательности, определение результата каждой задачи.

Инженерная задача

Возьмите программный проект :

  1. декомпозируйте его на 8–12 задач (детализируйте до проверяемого результата);
  2. для каждой задачи укажите ориентировочную длительность и зависимости от других задач;
  3. соберите из задач план-график.

Артефакт: план работ проекта

2. Отслеживание прогресса

План сам по себе не гарантирует исполнения — нужен механизм регулярного контроля: статус каждой задачи, отклонение от плана, решение при отставании.

Инженерная задача

Артефакт: отчёт о статусе проекта.

3. Управление рисками

Разработка подвержена рискам — событиям, которые могут нарушить план. Управление риском — это идентификация, оценка вероятности/влияния и заранее продуманная реакция.

Инженерная задача

Для проекта составьте список рисков:

  1. минимум 5 рисков разной природы (технические, ресурсные, внешние, организационные);
  2. для каждого — вероятность, влияние на срок/качество/бюджет;
  3. для каждого — стратегия реагирования (избежать, снизить, принять, передать) с конкретным действием.

Артефакт: реестр рисков

4. Документирование как артефакт процесса

Документация — не самостоятельная сущность, а такой же артефакт процесса, как код или тесты: у неё есть функция, читатель, и её создание/актуализация — работа, которую нужно планировать и отслеживать.

Инженерная задача

Для программного проекта:

  1. определите, какие виды документов нужны, и для каждого укажите его функцию и читателя (кто и зачем будет им пользоваться — разработчик, пользователь, заказчик, служба поддержки);
  2. укажите, какой документ из вашего списка чаще всего устаревает первым и почему — свяжите это с одним из рисков из предыдущей задачи.

Артефакт:

5. DocsOps

Автоматизация документирования — прямая параллель с автоматизацией тестирования и встроенным контролем качества: цель не «больше документов», а быстрая и надёжная актуализация документации как часть процесса разработки, без ручного дублирования усилий.

Инженерная задача

Возьмите документы из раздела 4 и разделите их на две группы с обоснованием:

Можно генерировать/проверять автоматически Требует ручной работы
(документ + источник автогенерации: код, тесты, схема API…) (документ + почему ручной: требует интерпретации, ориентирован на бизнес-аудиторию…)

Для одного документа из левой колонки опишите, из какого источника и каким инструментом/механизмом он мог бы генерироваться.

Артефакт: план автоматизации документирования (DocsOps).