Как вы относитесь к русскому языку в documentation comments?

Question

[ajile]

В наших проектах мы используем JSDoc для генерации документации. Комментарии пишем на английском языке, хотим перейти на русский. Но использовать русский язык в коде (даже в комментариях) кажется не правильным, хотя видимых причин я не вижу, в то время как преимущества очевидны.

Собственно вопрос: Как вы относитесь к использованию русского языка для комментирования кода и в частности для написания documentation comments?

Comments

[Руслан Гильфанов]

Пишите комментарии на языке общения команды.

Answer 1

[sim3x]

Плохо отношусь

Answer 2

[Дмитрий Беляев]

Your code must be in English only!
Ибо комментарии на русском однажды для кого-то могут оказаться таким же бесполезным мусором, как для нас с Вами комментарии на китайском

Answer 3

[Владимир Куц]

Если пишете не на 1С, то использовать русский в комментариях - особого смысла не вижу...

Comments

[ajile]

Про 1С клише какое-то, извините :)

В документировании кода на русском языке смысл в экономии времени, затрачиваемого на написание документации. Ведь не все разработчики в отдельно взятой команде хорошо знают английский, и не все должны его знать (в частности к стажерам и юниорам такие требования редко предъявляются). А использование английского ради английского зачастую приводит к тому, что во многих командах практика ведения документации отсутствует (ведь не на русском же писать документацию, а английский знают плохо и не все).

Чтобы вести документацию на английском языке, все члены команды должны хорошо знать английский, иначе ведение документации будет затратно по времени и большого количества грамматических ошибок не избежать. В общем профит от использования русского языка я вижу в этом.

[Stepanya]

ajile: Если стажеры не будут использовать английский, то когда они подрастут, вы получите сеньёров не знающих английский.