По роду деятельности мне часто приходится сталкиваться с "чужими" исходными кодами на языке VIP. Приходится читать и анализировать, что там написали программисты. Полагаю многим из Вас также доставался унаследованный код. Либо приходилось передавать свой код другим людям из своей же команды. Когда чужой код оформлен аккуратно в хорошем стиле, его приятно читать и проще разбираться. Но когда люди игнорируют правила хорошего тона, пишут код как попало, или используют свой непонятный никому стиль - такие коды трудно читать и понимать.
Возможно если кто то из посетителей форума, задавался целью, организовать у себя в группе общие правила и стиль кодирования. Но ленился или откладывал реализовать это мероприятие. То за основу вы можете взять наш документ: Корпоративный стандарт - Правила кодирования (редакция 2.1 от 26.01.2005 на 9 листах)
В отделе разработки Галактики также работает большая команда программистов. Мы стараемся соблюдать этот стандарт. Это существенно облегчает жизнь программистам при передаче кода друг другу. Приятно когда люди говорят на одном языке.
Кроме правил кодирования, возможно, вам пригодится документ Корпоративный стандарт - Требования к разработке пользовательских интерфейсов (редакция 4.0 от 21.12.2005, с дополнениями от 06.08.2007 и 14.11.2008). Этот документ описывает общие принципы и подходы к организации интерфейсов галактики и к оформлению отчетов.
Надеюсь этот опыт вам также пригодится.
Стиль кодирования на языке VIP
-
- партнер
- Сообщения: 28
- Зарегистрирован: Пт, 19/10/2007 11:49
- Имя Фамилия: Петр Кузьмин
- Откуда: ЗАО "Галактика Про"
- Контактная информация:
Re: Стиль кодирования на языке VIP
Всем, кто работает хотя бы в небольшом коллективе программистов, проблема хорошо известна и понятна.
Желание навести маломальский порядок, действительно приводит к мысли о введении правил, стандартов, регламента и т.д. Поэтому стандарты это хорошо и они должны быть. Но на практике очень тяжело заставить человека (да и себя тоже) писать не так как он привык годами (задача сравнима с борьбой с курением). В результате разворачивается вечный бой за красоту и стильность кода. Я считаю, что кроме стандартов должна быть еще утилита которая бы умела приводить исходник со всяческими безобразиями к виду описанному в нашем стандарте. Перед помещением в хранилище исходник автоматически должен проходить обработку. Только связка стандартов со средством их достижения решит проблему. Может быть, добавить в планы по Viper-у.
Желание навести маломальский порядок, действительно приводит к мысли о введении правил, стандартов, регламента и т.д. Поэтому стандарты это хорошо и они должны быть. Но на практике очень тяжело заставить человека (да и себя тоже) писать не так как он привык годами (задача сравнима с борьбой с курением). В результате разворачивается вечный бой за красоту и стильность кода. Я считаю, что кроме стандартов должна быть еще утилита которая бы умела приводить исходник со всяческими безобразиями к виду описанному в нашем стандарте. Перед помещением в хранилище исходник автоматически должен проходить обработку. Только связка стандартов со средством их достижения решит проблему. Может быть, добавить в планы по Viper-у.
- larin
- топ-софт
- Сообщения: 228
- Зарегистрирован: Пн, 10/09/2007 12:13
- Имя Фамилия: Михаил Ларин
- Откуда: ТопCофт
- Контактная информация:
Re: Стиль кодирования на языке VIP
В планах по Viper это есть, частично есть наработки. Результат будет но не скоро.
- larin
- топ-софт
- Сообщения: 228
- Зарегистрирован: Пн, 10/09/2007 12:13
- Имя Фамилия: Михаил Ларин
- Откуда: ТопCофт
- Контактная информация:
Re: Стиль кодирования на языке VIP
Кстати обновлю тему. В форматор кода для языка VIP был реализован в Viper 5.5.
Подробнее см ветку обсуждения Viper https://forum.galaktika.ru/viewtopic.php?p=4652#p4652
Подробнее см ветку обсуждения Viper https://forum.galaktika.ru/viewtopic.php?p=4652#p4652