Поговорим о документации. Как известно, что не документировано, то благополучно позабыто. Часто те, кто любит кодить, к обновлениям документации относятся плохо. Как раз для них создана концепция Docs Like Code, описанная в одноимённой книге – Docs Like Code by Anne Gentle
Краткий спойлер: когда у вас сложный проект с десятками постоянно допиливаемых сервисов, документация может стать кошмаром. Если вести её в Git, используя Gitflow, можно снять многие боли, воспользовавшись уже налаженным процессом для разработки.
Книга будет интересна прежде всего техническим писателям и проектным менеджерам. Впрочем, разработчики, занимающиеся документацией тоже наверняка её оценят. Мы в Mad Devs уже начали внедрять подход Docs Like Code, и пока результаты нас радуют.
Краткий спойлер: когда у вас сложный проект с десятками постоянно допиливаемых сервисов, документация может стать кошмаром. Если вести её в Git, используя Gitflow, можно снять многие боли, воспользовавшись уже налаженным процессом для разработки.
Книга будет интересна прежде всего техническим писателям и проектным менеджерам. Впрочем, разработчики, занимающиеся документацией тоже наверняка её оценят. Мы в Mad Devs уже начали внедрять подход Docs Like Code, и пока результаты нас радуют.