Документация для проекта

Категории: Кейсы Практики

Вопрос

Какую документацию может/должен подготовить именно PM, чтобы после релиза команде разработки было удобнее поддерживать продукт?

Ответ

У документации есть существенные недостатки:

  • Документацию никто не читает
  • Документация не актуальна (решение изменилось, а документацию забыли поправить) - типичная проблема
  • Документации всегда недостаточно или она настолько излишня, что сложно удержать в голове

Поэтому, в среде разработчиков считается, что вся документация должна быть сосредоточена в коде. Но этого недостаточно для людей, которые не умеют читать код :)

В целом же, достаточно иметь актуальную документацию по проекту, актуализировать ее по итогу проекта (в зависимости от того, насколько сложное решение у вас):

  • Актуализированные требования (Техническое задание) по проекту
  • Руководство пользователя
  • Руководство администратора
  • Архитектура решения
  • Схема развертывания и зависимости решения
  • Макеты, Карта сайта и т.д.
  • Полезно иметь доступ к таск-треккеру, поскольку в задачах тоже содержится полезная информация (поиском по ней найти)
  • Для разработчиков важно иметь доступ к репозиторию, иметь возможность смотреть коммиты и делать поиск по ним (это тоже документация)
  • Переписка, почта - здесь содержится информация о том, какие решения были приняты и почему они были приняты
  • В документах полезно иметь лист изменений, где описана версия документа, что изменилось и почему изменилось.

И в целом - всю эту документацию готовит не столько Менеджер проекта, сколько контролирует, чтобы она появлялась на проекте и была актуальной.

Все посты написаны мной. Если вам интересно узнать больше, подписывайтесь на мою рассылку о менеджменте. Один-два раза в месяц я пишу статьи о разных аспектах проектного управления или менеджмента в целом. Или вы можете просто написать мне :)