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

Здравствуйте, Pushkin, Вы писали:

P>На каком языке должны писаться комментарии в исходном коде, если все разработчики — русские?
Лучше писать комментарии на английском, имхо. Если заказчик иностранец — тогда однозначно.
К тому же если используется автодокументирование кода, который потом пойдёт в "мир" — тоже лучше на английском...
А если сами для себя и никому больше — тогда можно и на русском

Здравствуйте, Pushkin, Вы писали:

P>На каком языке должны писаться комментарии в исходном коде, если все разработчики — русские?

На мой взгляд, на языке, того кому будет передан (кто будет использовать) этот исходный код.

Здравствуйте, Pushkin, Вы писали:

P>На каком языке должны писаться комментарии в исходном коде, если все разработчики — русские?

// next line is removed nahren

У нас в конторе все разработчики — русские, но хозяин английский.
Пишем по-английски, в редких случаях используя непереводимую игру букв .

Здравствуйте, Кодт, Вы писали:

К>Здравствуйте, Pushkin, Вы писали:

P>>На каком языке должны писаться комментарии в исходном коде, если все разработчики — русские?

К>

К>// next line is removed nahren
К>

Старая байка про то, как в Microsoft (может и не там, не суть) в одном из исходников обнаружили строчку

Don't forget to remove this line NAHREN!

И потом долго голову ломали — а чеж такое этот nahren?

Здравствуйте, Flamer, Вы писали:

Только было чуток по-другому:

Don't forget to remove it HAXPEH!

Голову как раз ломали над "хакспех"

Здравствуйте, orangy, Вы писали:

O>Лучше писать комментарии на английском, имхо. Если заказчик иностранец — тогда однозначно.

Заказчик заказывает экзешник. Ему по большому счёту (должно быть) наплевать на язык комментариев. На 99% и дальше проект будут вести только русские.

Я чего опасаюсь... Мы все учились понемногу... Нам хватает (в общем-то) читать MSDN. Но это читать. Нет, писать мы тоже могём, но это напряг некий. А как только напряг, мы же похерим. Мы будем упрощать, выкидывать тонкости, а иногда и просто поленимся писать. Надо, чтобы было максимально легко, тогда хоть что-то будем писать. А иначе дубина нужна железная. Кроме того, откуда я могу быть уверен, что тот, кто написал этот комментарий действительно имел в виду. Это некий дополнительный квест, зачем он? Вот это основной вопрос, я не чувствую зачем?

Здравствуйте, _Dinosaur, Вы писали:

P>>На каком языке должны писаться комментарии в исходном коде, если все разработчики — русские?
D>На мой взгляд, на языке, того кому будет передан (кто будет использовать) этот исходный код.

Код пишут только русские. Экзешник имеет только английский интерфейс. Проект замкнут. Никакого кода наружу.

Здравствуйте, Кодт, Вы писали:

К>У нас в конторе все разработчики — русские, но хозяин английский.

О! Оно.

К>Пишем по-английски, в редких случаях используя непереводимую игру букв .

Вот я и хочу понять, зачем себя мучить? Исключительно для саморазвития?

Здравствуйте, Pushkin, Вы писали:

P>Здравствуйте, _Dinosaur, Вы писали:

P>>>На каком языке должны писаться комментарии в исходном коде, если все разработчики — русские?
D>>На мой взгляд, на языке, того кому будет передан (кто будет использовать) этот исходный код.

P>Код пишут только русские. Экзешник имеет только английский интерфейс. Проект замкнут. Никакого кода наружу.

В таком случае лучше на русском,
т.к. в команде может появиться программист не владеющий английским.
(надо только с кодировкой определиться )

Здравствуйте, Pushkin, Вы писали:

O>>Лучше писать комментарии на английском, имхо. Если заказчик иностранец — тогда однозначно.
P>Заказчик заказывает экзешник. Ему по большому счёту (должно быть) наплевать на язык комментариев. На 99% и дальше проект будут вести только русские.
Не совсем так. Если клиент покупает ваш труд — он получает все права на интеллектуальную собственность. Если он не работает с вами уже годами — он будет требовать исходный код, на всякий случай. Чтобы было, вдруг вы куда-нибудь денетесь. Тогда он сможет продолжить проект с другими. И будь уверен, даже если он ничего не поймёт, он туда посмотрит.
Хотя, конечно, люди (в том числе и клиенты) бывают разные. Просто решите этот вопрос с владельцем кода и всё.

P>Я чего опасаюсь... <...> Нет, писать мы тоже могём, но это напряг некий. А как только напряг, мы же похерим. <...>
Ну вопросы организации труда, проблемы квалификации программистов, знание языков никак не относятся к системе комментариев. Косвенно, конечно, да, но первичным фактором должен быть продукт. Если в продукт, который вы продаёте, услугу которую оказываете, входит качественно документированный код — куда бы вы делись с подводной-то лодки А ежели заказчику действительно наплевать, из чего спаяна его программка и он это прямо говорит — так ради бога, хоть азбукой морзе комментируйте

Здравствуйте, Pushkin, Вы писали:

P>Здравствуйте, orangy, Вы писали:

O>>Лучше писать комментарии на английском, имхо. Если заказчик иностранец — тогда однозначно.

P>Заказчик заказывает экзешник. Ему по большому счёту (должно быть) наплевать на язык комментариев. На 99% и дальше проект будут вести только русские.

Орандж прав на 110%. Все зависит от того, что именно заказывает заказчик. См. договор. Если екзешник — то делайте, что хотите. Лучше, ессно, иметь внутренние стандарты на оформление кода, в том числе и на комментарии. Но если заказчик покупает исходники, то надо согласовывать с ним эти правила оформления. В том числе и комментариев.

Здравствуйте, orangy, Вы писали:

O>Хотя, конечно, люди (в том числе и клиенты) бывают разные. Просто решите этот вопрос с владельцем кода и всё.

Мне на самом деле это больше "из любви к искусству" интересно
Бог с ним, с заказчиком. Пусть он насквозь русский. Или я вообще для себя пишу.
Я хочу понять, как правильно? С точки зрения профессии.
Иными словами, английский язык комментариев улучшает качество кода или нет?

Здравствуйте, Pushkin, Вы писали:

P>Мне на самом деле это больше "из любви к искусству" интересно
P>Иными словами, английский язык комментариев улучшает качество кода или нет?
Ну так бы и говорил. Я думаю, что английский больше подходит для кода, нежели русский. Но понятно, что если языка не знаешь — тут уж хоть прыгай, хоть бегай.
А вообще — качество кода улучшает улучшение мозгов, которые этот код пишут

P>Вот я и хочу понять, зачем себя мучить? Исключительно для саморазвития?
Зачем надо писать комментарии по английски начинаешь понимать, когда
тебе на руки сваливаются исходники, в которых комментарии
написаны по-корейски, или по-немецки, или по-итальянски.

В отдельных случаях попадаются исходники, в которых по-русски или по-корейски
именуются идентификаторы — причем, прям в родных кодировках, благо, что,
например Java это позволяет. Убыв бы. NAXPEN.

Вообще, большое количество комментариев в коде ( а не в сопроводиловке )
— очень опасный признак.

P>Иными словами, английский язык комментариев улучшает качество кода или нет?

Комментарии вообще не особенно улучшают качество кода. Особенно,
когда теряют актуальность, и в них написано враньё, которое никто
не удосужился исправить.

Здравствуйте, dmz, Вы писали:


P>>Вот я и хочу понять, зачем себя мучить? Исключительно для саморазвития?
dmz>Зачем надо писать комментарии по английски начинаешь понимать, когда
dmz>тебе на руки сваливаются исходники, в которых комментарии
dmz>написаны по-корейски, или по-немецки, или по-итальянски.
Это верно, но только если это OpenSource или legancy какой-то... В заказных проектах такого почти не бывает.
Другое дело, что плохо вот такое (реальный комментарий из реального кода)

//Class for manipulations in parameters of actions

dmz>Вообще, большое количество комментариев в коде ( а не в сопроводиловке )
dmz>- очень опасный признак.
Опасно не большое количество, а тривиальные комментарии. Типа

if (a>0) // если а больше нуля тогда...
...

Здравствуйте, dmz, Вы писали:


P>>Иными словами, английский язык комментариев улучшает качество кода или нет?
dmz>Комментарии вообще не особенно улучшают качество кода.

Ну конечно, они просто относятся к сопровождению, а не разработке. А стоимость сопровождения напрямую зависит от качества комментариев.

Здравствуйте, Sinclair, Вы писали:

S>Лучше, ессно, иметь внутренние стандарты на оформление кода, в том числе и на комментарии

О них и речь.

Здравствуйте, orangy, Вы писали:

dmz>>Вообще, большое количество комментариев в коде ( а не в сопроводиловке ) — очень опасный признак.
O>Опасно не большое количество, а тривиальные комментарии.

Мне вот чё-то сейчас подумалось, что каждая функция (кроме сгенерённых ClassWizzard-ом типа OnKeyDown) и каждая переменная-член-класса должны быть откомментированы. Я прав? Сам я правда не делаю ничего подобного