Комментарии в тексте программ

Пиши так как самому понятнее

English only

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

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

Ты познал дао задавания вопросов: ответ на вопрос содержится в вопросе :)

На английском, разумеется..

Deutsch!

На английском проще - раскладку переключать не надо :)

// this file is in UTF-8

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

Работаю в компании, разрабатывающей компиляторы и линтеры для vhdl/verilog/system verilog, и иногда приходится встречать, как клиенты присылают свои исходники с исчерпывающими коментариями гм... на японском языке:)

После этого невольно задумываешься о нелегкой судьбе иностранцев, которые вынуждены разбирать кириллицу (да еще и не в УТФ, а в какой-нибудь ЦП 1251) в комментариях к чужому коду.

Имхо, в таком случае идеально было бы дублировать на английском и русском, но слишком муторно. Потому если знаешь англ. - пиши на нём, если очень плохо знаешь - уж лучше на русском, пусть тебя поймёт хоть кто-то. :)

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

Для человека, не знающий русского, комментарии на корявом английском в миллион раз ценнее комментариев на идеальном русском.

> С учетом того что много людей

У ты у_три_руй. То есть одновременно (и внезапно, ессно):

- на русском в УТФ;

- на русском в транслите;

- на русском английским.

Как-то так.

English only. Вообще пора заканчивать с этим зоопарком языков.

Пиши на глаголе (с) (тм)!

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

Пусть русский учат, нам же английский учить не западло

> На английском проще - раскладку переключать не надо :)

А если (о, ужас!) адинэс?

Технический английский - это двести слов плюс профессиональная лексика. Технический русский - это то же самое, если не употреблять мат.

> // this file is in UTF-8

// this life is in UTF-8

> Технический английский - это двести слов плюс профессиональная лексика. Технический русский - это то же самое, если не употреблять мат.

А если употре<skipped>, то пять

>А если (о, ужас!) адинэс?

Вот прямо сейчас смотрю конфу и не вижу вообще ни одного комментария. Выбираю инструмент убийства.

>А если употре<skipped>, то пять

В этом и сложность. Русское словообразование - штука мощная, но иноязычным неподсильна (при разумных усилиях).

> Вот прямо сейчас смотрю конфу...

Твое конфу против моего?:-)

>В этом и сложность. Русское словообразование - штука мощная, но иноязычным неподсильна (при разумных усилиях).

русскоязычные статьи в иностранных научных журналах цитируются. Так что не надо гнать на ниасиливших

Да я и не гоню, но ты сравни научных работников и программеров на пыхе.

Кому надо - прочтёт хоть на суахили

> Русское словообразование - штука мощная, но иноязычным неподсильна (при разумных усилиях).

Потомок Задорнова?

>Твое конфу против моего?:-)

Я щас тыкнул в часиках под виндой кнопку "синхронизироваться с time.nist.gov". Оно засинхронизировалось и пишет "Синхронизация с сервером времени в Интернете никогда не выполнялась". Я очень заинтересован в том, чтобы посмотреть комментарии к этой части кода.

>Потомок Задорнова?

Нет.

> во вторых русский - кгхм - зоопарк кодировок

Вендузятнег детектед! А ещё русская езыка очень правила сложные имеет, ога?

На хинди

>В этом и сложность. Русское словообразование - штука мощная, но иноязычным неподсильна (при разумных усилиях).

Будем равняться на одноклеточных?

//капча sexting (sex + sting) ;-)

Разумно, если учесть, кто потенциальный чтец.

Комментарии пишут для:

* себя
* других.

Если код для себя, то писать imho следует на ... том, что вам удобно, если для других - то на... том, что им удобно. Случай садо-мазо сознательно выпускаем из рассмотрения. ;-)

Иногда код пишут для себя и других...Но это сложно.

Так ты же всё равно ни хрена не поймёшь... или ты знаешь хинди?

ну выучи эсперанто!

по-русски , разумеется

> Пиши так как самому понятнее

+1. Пиши на русском если с английским не очень.

Суахили, разумеется.

>Ты познал дао задавания вопросов: ответ на вопрос содержится в вопросе :)

Чтобы правильно задать вопрос, нужно знать больше половины ответа.

> Если код для себя, то писать imho следует на ... том, что вам удобно, если для других - то на... том, что им удобно. Случай садо-мазо сознательно выпускаем из рассмотрения. ;-)

Ыменно. Я пишу на русском (для себя) и на буржуйском (на работе).

Правильнее так, как тебе удобно. Если хорошо владешь английским, пиши на английском.

Шекли тоже умер....

>> Шекли тоже умер....

В 2005. Ну и как там, в анабиозе?

ИМХО это был просто комментарий к месаджу (взятому из Шекли), навеяный соседним топиком, а не выкладывание факта.

> После этого невольно задумываешься о нелегкой судьбе иностранцев, которые вынуждены разбирать кириллицу (да еще и не в УТФ, а в какой-нибудь ЦП 1251) в комментариях к чужому коду.

А почему надо подстраиваться под иностранцев? Чем английский лучше?

1. из соображений однозначности - на английском;
2. из соображений производительности - на нативном языке коллектива программистов;
3. из соображений профессионализации - на другом языке программирования;
4. из соображений индивидуальности - на своём собственном;

правильно - это когда один раз выбрал и не отступаешь.

> Ты познал дао задавания вопросов: ответ на вопрос содержится в вопросе :)

Ты познал суть риторических вопросов:-)