rvachev.orgEN / RU / 🤖
← К эссе
· Эссе · 1 мин

Документация возвращается

Долгое время количество документации к коду неуклонно снижалось. AI переломит этот тренд.

📝 Документация возвращается

Долгое время количество документации к коду неуклонно снижалось. Agile манифест, "код - лучшая документация", постоянные изменения делали ее устаревшей быстрее, чем она писалась.

AI переломит этот тренд. Причина проста: имея хорошую спецификацию, AI работает значительно лучше. Это создает прямой стимул документировать.

Поймал себя на том, что начал добавлять к часто используемым заметкам - планы на год, мысли после книги, списки - отдельный MD-файл с подробным описанием формата: зачем эта заметка нужна, какая у нее структура, как ее обновлять.

Естественно, пишу их не сам - генерю с помощью AI по своим мыслям.

Win-win: AI работает точнее, а мне самому полезно перечитывать эти спецификации через какое-то время неиспользования.