Разработчика Кислая Верму возмутила статья на medium.com о причинах, по которым программисты не пишут документацию. В частности, он не согласен с тем, что главная проблема — отсутствие хороших инструментов. По мнению автора, на самом деле есть две других основных причины. Вот они:
Первой причиной Кислай Верма называет сложность процесса. Подготовка документации — сложная и ответственная задача, которая требует организации мыслей, критического анализа и четкого выражения. Писать становится все сложнее: надо установить контекст, обосновать решения, а затем задействовать низкоуровневое мышление, ведущее к кодированию. Плохой код все равно будет «летать», плохая документация — нет.
Если разработчик не пишет документацию, его работа все равно выполняется. Отсутствие документации не отменяет доставку продукта, а ущерб, нанесенный отсутствием документирования технических решений, проявляется не сразу. К тому же, в большинстве случаев можно кодировать «на коленке»: неорганизованная куча классов и методов в коде может работать, а вот бессмысленная куча слов и абзацев не сработает.
Кислай Верма считает, что для создания грамотной документации нужны инструменты, которые помогут на протяжении долгого времени эффективно собирать идеи для решения задачи. По мнению автора, Google Docs, Confluence и Markdown — плохие инструменты для этого. Он делает ставку на новое поколение приложений — таких как Notion и Roam Research.
Автор считает, что единственный способ сделать процесс написания документации стабильным — сделать его легким, но обязательным. Вот что автор советует разработчикам:
Сегодня мы поговорим о том, как выбрать лучшие курсы Power BI в Украине, особенно для…
В 2023 году во всех крупнейших регионах конкуренция за вакансию выросла на 5–12%. Не исключением…
Unicorn Hunter/Talent Manager Лина Калиш создала бесплатный трекер поиска работы в Notion, систематизирующий все этапы…
Edtech-стартап Mate academy принял решение отправить своих работников в десятидневный отпуск – с 25 декабря…
Служба безопасности Украины задержала в Киеве 46-летнего программиста, который за деньги устанавливал шпионские программы и…
IT-специалист Джордан Катлер создал и выложил на Github подборку разнообразных ресурсов, которые помогут достичь уровня…