LINUX.ORG.RU
ФорумTalks

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


0

0

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

★★★★★

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

alphex_kaanoken ★★★
()

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

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

MYMUR ★★★★
()

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

MiracleMan ★★★★★
()

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

cobold ★★★★★
()

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

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

V_L_A_D ★★
()

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

Ramen ★★★★
()
Ответ на: комментарий от cobold

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

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

MYMUR ★★★★
()

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

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

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

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

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

Как-то так.

CkuB
()

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

anonymous
()
Ответ на: комментарий от anonymous

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

anonymous
()
Ответ на: комментарий от DNA_Seq

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

anonymous
()
Ответ на: комментарий от anonymous

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

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

friday ★★★
()
Ответ на: комментарий от friday

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

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

anonymous
()
Ответ на: комментарий от friday

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

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

anonymous
()
Ответ на: комментарий от anonymous

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

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

DNA_Seq ★★☆☆☆
()
Ответ на: комментарий от anonymous

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

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

friday ★★★
()
Ответ на: комментарий от friday

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

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

anonymous
()
Ответ на: комментарий от alphex_kaanoken

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

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

Gharik
()
Ответ на: комментарий от anonymous

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

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

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

anonymous
()
Ответ на: комментарий от anonymous

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

redgremlin ★★★★★
()

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

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

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

record ★★★★★
()
Ответ на: комментарий от record

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

record ★★★★★
()
Ответ на: комментарий от anonymous

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

anonymous
()
Ответ на: комментарий от cvs-255

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

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

halflife ★★
()

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

Deleted
()
Ответ на: комментарий от MYMUR

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

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

vada ★★★★★
()
Ответ на: комментарий от record

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

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

Beria1937
()

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

smh ★★★
()
Ответ на: комментарий от Gregon

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

redgremlin ★★★★★
()
Ответ на: комментарий от V_L_A_D

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

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

cvs-255 ★★★★★
()

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

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

TIM
()
Ответ на: комментарий от vada

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

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

friday ★★★
()
Вы не можете добавлять комментарии в эту тему. Тема перемещена в архив.