LINUX.ORG.RU
ФорумTalks

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


0

0

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

★★★★★

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

English only

thrall ()

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

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

alphex_kaanoken ★★★ ()

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

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

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

MYMUR ★★★★ ()

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

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

MiracleMan ★★★★★ ()

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

Deutsch!

anonymous ()

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

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

cobold ★★★ ()

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

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

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

V_L_A_D ★★ ()

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

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

Ramen ★★★★ ()
Ответ на: Re: Комментарии в тексте программ от cobold

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

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

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

MYMUR ★★★★ ()

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

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

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

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

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

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

Как-то так.

CkuB ()

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

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

anonymous ()

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

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

anonymous ()
Ответ на: Re: Комментарии в тексте программ от anonymous

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

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

anonymous ()

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

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

DNA_Seq ★★☆☆☆ ()
Ответ на: Re: Комментарии в тексте программ от anonymous

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

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

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

friday ★★★ ()
Ответ на: Re: Комментарии в тексте программ от anonymous

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

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

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

DNA_Seq ★★☆☆☆ ()
Ответ на: Re: Комментарии в тексте программ от friday

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

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

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

anonymous ()
Ответ на: Re: Комментарии в тексте программ от alphex_kaanoken

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

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

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

Gharik ()
Ответ на: Re: Комментарии в тексте программ от anonymous

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

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

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

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

anonymous ()

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

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

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

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

record ★★★★★ ()

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

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

Deleted ()
Ответ на: Re: Комментарии в тексте программ от MYMUR

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

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

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

vada ★★★★★ ()
Ответ на: Re: Комментарии в тексте программ от record

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

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

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

Beria1937 ()

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

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

smh ★★★ ()
Ответ на: Re: Комментарии в тексте программ от Gregon

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

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

redgremlin ★★★★★ ()
Ответ на: Re: Комментарии в тексте программ от V_L_A_D

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

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

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

cvs-255 ★★★★★ ()

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

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

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

TIM ()
Ответ на: Re: Комментарии в тексте программ от vada

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

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

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

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