← ALB News · curated headline

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

Habr · RU · Programming · 11/16/2026, 9:53:40 AM

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

Continue to Habr →

You are being forwarded in 6s — stay on this page