Разработка документации проекта (описание проекта)


Помните, как Стив Балмер прыгал на сцене и кричал: «Девелоперс! Девелоперс! Девелоперс! Девелоперс!»?


Так и мне хочется кричать: «Документация! Документация! Документация! Документация!»

О чего больше всего страдают проекты? Вернее, не сами проекты, а основатели проектов и стартапов? От отсутствия документации.

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

Если вся идея есть лишь в голове у основателя или основателей, то отсюда возникает мощнейшие две проблемы:

  • нет уверенности в целостности и непротиворечивости этой идеи и проекта;
  • затруднительно привлекать сторонних специалистов.

«Гладко было на бумаге, да забыли про овраги». А тут ещё хуже ситуация: в голове кажется, что всё логично и органично. Логика есть в проекте и очевидно, что всё реализуемо и нет никаких трудностей. Всё четко и ясно. Но стоит начать проект описывать, как возникают нестыковки: то тут надо продумать логику, то там ещё не известно, как поступить. Или вообще одна идея противоречит второй.

Это как каркас дома: понятно, как и где он будет стоять, понятны примерные размеры. Но планировка внутри не ясна совершенно. От этого стороннему наблюдателю даже не понятно, что это за строение: жилой дом, бассейн, пожарная часть?

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

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

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

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

https://www.phoronix.com/news/Intel-2023-Survey-Results

Вывод один — надо описывать проект. Детально. Да, ваш бриф проекта может быть в пределах 2-3 листов. Для первоначального погружения в проект этого достаточно.

А вот подробное описание проекта (это еще не техническое задание!) редко составляет менее 20-30 страниц.

В силу NDA я не могу привести скриншоты документации проектов, поэтому я выдумал проект и показал, как примерно должен быть описан проект:




Комментарии