Forum.iFiction.Ru

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

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

Вы не зашли.

0    0    #1
18.11.2008 10:51

imbeat
Участник
Откуда: Москва, Зеленоград
Зарегистрирован: 05.03.2008
Сообщений: 21

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

добрый всем день!
пара вопросов-комментариев-прозьб по поводу комментариев к классам, методам, константам в библиотеках Rtads:
1) комментарии на английском было бы хорошо перевести на русский
2) комментарии на русском и английском
например:

Код:

#define EC_SUCCESS        0                    /*        удачное завершение */
                                               /*     successful completion */

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

Неактивен

0    0    #2
19.11.2008 10:00

imbeat
Участник
Откуда: Москва, Зеленоград
Зарегистрирован: 05.03.2008
Сообщений: 21

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

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

Неактивен

0    0    #3
19.11.2008 16:21

imbeat
Участник
Откуда: Москва, Зеленоград
Зарегистрирован: 05.03.2008
Сообщений: 21

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

про табы и пробелы я не говорил, а лишь про английские комменты... и то теперь согласен что они нужны!

Неактивен

Powered by PunBB
© copyright 2001–2024 iFiction.Ru