Почему документацию пора перестать хранить в виде документа
Habr ·

Когда создаешь техническую документацию в Word, периодически проходишь и отрицание, и гнев, и торг, и все остальные этапы принятия. Сначала надеешься, что функции мы менять не будем или обойдется минимумом правок. А понимая, что правки все-таки будут и вносить изменения нужно в десяток файлов, хочешь сжечь рабочее место. Но проблема не в Word. Как инструмент, он неплохо справляется со своими задачами - помогает оформлять документы. Только вот строить вокруг этого написание именно документации не стоит. Вордовский файл не должен быть “квантом” информации для продуктового описания. В разработке ПО мы уже прошли путь от редактирования простыней кода к делению их на модули, системам контроля версий и автоматической сборке. В том же направлении давно пора идти и с технической документацией. И этот путь прослеживается. В нем отрасль отталкивается не от конкретных инструментов, а от логики построения работы. Читать далее