352просмотров
15 июня 2025 г.
Score: 387
Давайте поговорим про документацию Я много раз пытался придумать себе "идеальную систему".
Но чем дальше, тем больше прихожу к простому: документация — это не хранилище, а верный помощник для мозга. Оставляю README рядом с кодом.
Иногда завожу wiki, если проект живой и большой.
На проде часто пишу себе «шпаргалки админа» — по сути просто текстовики с командами, которые пригодятся, когда что-то пойдёт не так. Главная беда документации — её либо нет, либо она устарела.
Пробовал когда-то Confluence, Notion, даже встроенные тулзы GitLab — результат всегда зависит только от того, кто пишет. 🧩 Интересно, как у вас с этим:
Где у вас живёт документация?
Что реально работает в жизни, а не в идеальных методичках?