Документация - зло?

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

И вот, один из разработчиков выступает с экстремистской мыслью.
"В аджайле документация - это вообще зло".
(читай: не надо документировать ее вообще)

Вокруг agile манифеста ходит очень много мифов и предубеждений. Каждый трактует принципы методологии как хочет.
Манифест гласит: работающий продукт важнее исчерпывающей документации.

👽 Принципы agile фокусируются на поставке ценности пользователям. Документация конечному пользователю не несет ценности, поэтому подход к документированию должен быть легковесным и не затратным. Но достаточным, чтобы можно было быстро разобраться любому разработчику.

👽 Кроме того, когда команда долго варится в agile процессах, кажется она забывает, что когда-то agile пришел как альтернатива каскадной (waterfall) модели. В ней принято выделять длительный этап написания ТЗ. И ценность такого подхода ставится под вопрос, потому что рынок и продукт - это живые, гибкие элементы. Исчерпывающее ТЗ может быть блокером роста и вызывать риск сделать то, чем не будут пользоваться.

Документация - не зло, это вопрос баланса в процессе разработки и поставке ценности пользователю.

Если разработчик говорит, что документация зло, то я бы озаботилась вопросом "Завтра этот человек уволится, кто-нибудь сможет понять его код? Не будет ли басфактора?". Ну и не забываем, что всегда можно обсуждать процессы с командой и ковырять ее заблуждения.

#разработка