Документация, которая не соответствует коду, — почти бесполезная документация 😱 Знакомая ситуация: открываешь внутреннюю вики, находишь инструкцию, а там сервис, который уже год как вывели из эксплуатации. Закрываешь вкладку и идешь спрашивать коллегу. Проблема не столько в формате документации, сколько в процессе ее обновления. Если описание живет отдельно от разработки, оно неизбежно начинает отставать от кода. В новой статье разбираем подход, при котором документация становится частью самого процесса разработки. В Газпромбанк.Тех мы используем docs as code, и вот почему: 🔵 документация меньше отстает от кода 🔵 история изменений остается прозрачной 🔵 ревью текста становится частью стандартного процесса проверки 🔵 публикация не требует дополнительных ручных действий 🔵 материалы обновляются, пока контекст задачи еще свеж ▶️ В итоге документация перестает быть отдельной задачей «когда-нибудь потом» и остается синхронизированной с тем, что действительно работает. Разобрали подход, инструменты и то, как это устроено у нас — в статье. Мы в МАКС 💻

Что произойдет в JavaScript?