Forum.iFiction.Ru

iFiction.Ru · ifHub · FAQ · IFWiki · QSP · URQ · INSTEAD · AXMA

форум об interactive fiction, текстовых приключенческих играх и всём таком...

Вы не зашли.

   #1
18.11.2008 19:00

goraph
Участник (+432, -152)
Зарегистрирован: 16.04.2007
Сообщений: 486

Основная добродетель гражданина есть недоверие.

Комментарии в коде русских версий библиотек (advr.t и т.п.)

Они что, есть просят, эти комментарии? В первый раз слышу чтоб кто-то ругался что комментариев много.
В данном конкретном примере "successful completion" больше говорит о "EC_SUCCESS" чем "удачное завершение" - сразу понятно как произошло и как запомнить название.
Если убирать английские комменты надо менять все названия переменных и функций - например doTake на delaiVziat и т.д. - чтоб комментарии были адекватны. Правда вот ни одна скачанная библиотечка не будет больше работать.

Неактивен

   #2
19.11.2008 10:28

goraph
Участник (+432, -152)
Зарегистрирован: 16.04.2007
Сообщений: 486

Основная добродетель гражданина есть недоверие.

Re: Комментарии в коде русских версий библиотек (advr.t и т.п.)

imbeat написал:

любое уменьшение размера кода положительно сказывается на читабельности и легкости навигации по нему!

Вот не надо такой категоричности. Давайте тогда вообще все комменты, отступы и переносы строк удалим, будет раза в 3 меньше.
А ты вообще в курсе что некоторые (я например) читают англицкую документацию (не потому что мне не нравится что напереводил уух, а потому что оригинал это оригинал)? Думаешь легко потом будет переразбиратся в терминологии без комментов? Не говоря уж о том что полного русского мануала пока не существует в природе.

Неактивен

Powered by PunBB
© copyright 2001–2018 iFiction.Ru