Как вы относитесь к русскому языку в documentation comments?
В наших проектах мы используем JSDoc для генерации документации. Комментарии пишем на английском языке, хотим перейти на русский. Но использовать русский язык в коде (даже в комментариях) кажется не правильным, хотя видимых причин я не вижу, в то время как преимущества очевидны.
Собственно вопрос: Как вы относитесь к использованию русского языка для комментирования кода и в частности для написания documentation comments?
Your code must be in English only!
Ибо комментарии на русском однажды для кого-то могут оказаться таким же бесполезным мусором, как для нас с Вами комментарии на китайском
В документировании кода на русском языке смысл в экономии времени, затрачиваемого на написание документации. Ведь не все разработчики в отдельно взятой команде хорошо знают английский, и не все должны его знать (в частности к стажерам и юниорам такие требования редко предъявляются). А использование английского ради английского зачастую приводит к тому, что во многих командах практика ведения документации отсутствует (ведь не на русском же писать документацию, а английский знают плохо и не все).
Чтобы вести документацию на английском языке, все члены команды должны хорошо знать английский, иначе ведение документации будет затратно по времени и большого количества грамматических ошибок не избежать. В общем профит от использования русского языка я вижу в этом.
