Техническая документация, или откуда берутся скучные люди
В 15 лет, когда я был разработчиком, люди с технической документацией на 100 страниц казались мне самыми скучными. А недавно я сам зачитался инструкцией на 60 страниц о том, как работать с репозиторием на проекте. Короткая история о том, зачем нужна документация в разработке.
Когда мне было 15 лет и я был разработчиком, то максимально скучными казались эти люди, которые то и дело читают и пишут свои документации на 100 страниц. Вместо того, чтобы работать.
Так и представлял инженера на заводе, что он бегает с бумажками от кабинета к кабинету и ничего полезного не делает. Где весь драйв? И вообще аджайл разве не для этого придумали?
Сейчас в чате у коллег увидел инструкцию о том, как работать с репозиторием на проекте. На 60 страниц. И зачитался.
Вот откуда берутся скучные люди. Они просто когда-то зачитались.
Вопросы и ответы
Скучно ли читать документацию к проекту?
В 15 лет мне так казалось. А недавно я зачитался инструкцией на 60 страниц о том, как работать с репозиторием на проекте.
Противоречит ли документация agile?
Раньше я думал, что agile придумали как раз вместо бумажек на 100 страниц. Сейчас понимаю, что хорошая инструкция по репозиторию — не бюрократия, её интересно читать.