Крутая статья про документацию. Я честно скажу - терпеть не могу писать документацию и всячески поддерживаю инициативу введения роли технического писателя. А в этой статье роль как раз и описана. А еще описаны проблемы документации. На моей практике чаще всего встречались 2 и 3, хотя и 4 часто бывает и она особенно убивает мотивацию пользоваться документацией, реально в разы проще и главное надежнее спросить! https://habr.com/ru/company/oleg-bunin/blog/648317/
Документация и роль технического писателя
документациятехнический писательhabr