Локализация комментариев в коде

Яндекс — международная компания, и многими нашими сервисами пользуются за границей. Когда сервису API Яндекс.Карт пришла пора выходить на международный рынок, было принято решение полностью отказаться от комментирования кода на русском языке. Но на основе комментариев в коде формируются справочники сервиса, которые публикуются на портале Яндекса, и отказываться от поддержки справочников на русском языке мы не хотели.

Мы расскажем, как совместно с разработчиками API Карт мы поменяли язык комментариев с русского на английский, с какими проблемами столкнулись и как организовали синхронную поддержку справочников и примеров сразу на двух языках.