На каком языке писать комментарии для проекта?

Question

[Александр]

Русскоязычный проект, работать с ним будут русскоязычные, но во мне сидит твердое убеждение о том что нужно писать все комментарии на англ.
Нормально ли вообще писать их на русском?

Comments

[Otrivin]

А что в этом ненормального?

[Константин Нагибович]

А в чем проблема? Я вообще код на русском пишу.

Answer 1

[Алексей Елецкий]

На языке, на котором общается команда, с учётом будущего её развития.

В противном случае получится испорченный телефон.

Учтите, что родной язык знают все, а иностранный могут не знать (люди учат немецкий, французский, китайский, etc).

Answer 2

[dollar]

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

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

Answer 3

[tundramani]

твердое убеждение

— это догмат
ну типа не кошерно и не православно писать не на церковно-англицком
и не модно, фу ))

надо делать так как тебе удобно
если все русские - то лучше писать всё по русски

я работаю сам - всё делаю по-русски, и переменные тоже - так выше скорость работы
а если кого то это бесит - я ржу над такими инвалидами

Comments

[Crash]

Переменные на русском, транслит как я понимаю. Фу, жесть какая) Ржите дальше, рынок рано или поздно поставит вас на место. Сколько вам лет, если не секрет?)

[tundramani]

я не работаю на рынке
а ты работай и страдай

среда исполнения js позволяет использовать юникод - и это не вызывает ошибок

Answer 4

[Владимир Проскурин]

А если он завтра станет не русскоязычным? Или в команду разработки присоединиться англоязычный специалист?
Конечно лучше русские комментарии, чем корявые английские. Но если команда владеет английским, то лучше на английском.

Comments

[Александр]

Я уверен, что он не станет англоязычным и уж тем более англоязычные не подключатся.