Примеры правил кодирования.Андрей пишет:
"Нет ли у вас примера Соглашения о кодировании относительно Дельфи, VB или вообще какого-нибудь языка. Очень бы хотелось внедрить такое в нашей организации. Но самому изобретать велосипед относительно правил оформления текста программы на дельфи или бейсике не хотелось бы. Наверняка это уже есть, написано и оформлено."
Вот, привожу в неизмененном виде стандарты, используемые нами (прошу прощения за формат Word):
Delphi Code C++ Code
Max Belugin прислал вот это: http://jvcl.sourceforge.net/delphistyleguide.htm Рекомендации Sun для Java (zip) Соглашения проекта SHP
Кирилл Калишев: Cоглашения Java, написанные по принципу пример - антипример (zip) "У нас соглашения еще более простые, базированные на Sun (с некоторыми исключениями). Тем не менее, это то, что мы используем. Первое время это висело на видном месте. Потом, когда все привыкли, даже забыли про этот документ.
У меня уже был опыт прочтения соглашений в виде длинного документа. В общем, на мой взгляд, гораздо проще сделать "пример" и "антипример". Это быстрее усваивается и писать проще. Что и было сделано."
Правила кодирования фирмы ОЛИС: Для Delphi Для Interbase
Хочу, все-таки, отметить, что стандарты надо внедрять. Но внедрять должна сама команда, и для XP, на самом деле, не важно какие они. Они должны быть приняты командой так, чтобы все были согласны им следовать. Цель стандартов - устранение всех препятствий для понимания кода.
Не стоит увлекаться документированием всего и вся. Если, например, величина отступов ни для кого из команды не имеет значения, то и не надо ее в правила вносить. Путешествуйте налегке, как говорится.
Роман Еремин
|