REBOLution in Russia Wiki
Advertisement

Структурируйте для ясности содержание. Квадратных скобок блоков для ясности содержание не достаточно. Априори они связаны с синтаксисом, который определяет блок, но не содержание. Кроме того существует пространство между блоками, где скобки отсутствуют. Там где есть возможность, открывайте скобки для строк, ассоциируемых с выражениями. закрывающая скобка должна выражать больше, чем просто уровень, но и глубину. Это в равной мере относится и к круглым и фигурным скобкам. Старайтесь выделять связные выражения и сгруппированные. Аккуратно используйте переносы.

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

Де-табуляция прежде переноса - символ табуляции ASCII 9 не идентичен четырем пробелам во многих обозревателях, поэтому используйте редактор или REBOL функции для де-табуляции перед опубликованием.

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

Имена слов - демонстрируют ваш код. Относитесь к выбору имен очень критично. Имя должно быть кратким и ясным. Когда есть возможность используйте слова естественных языков. В простом прямой путь.

Используйте краткие слова, связанные со смыслом. Причем локальные слова могут быть короче простых слов, а длинные лучше использовать для глобальных слов. Используйте целые слова, где только возможно. Не стремитесь сокращать слова. Слово - редкая ценность!

Имена сложных слов иностранного происхождения используются стандартным стилем, но не символами, а используя тире.

Начинайте имена функций с глаголов. Только потом местоимения, наречия и прилагательные. Некоторые существительные могут использоваться как глаголы. Начинайте слова данных с существительных. Это слова для объектов и переменных, содержащих данные. Они могут включать модификаторы (прилагательные) при необходимости.

Используйте стандартные имена!

Заголовки скриптов используйте самым активным образом. Они позволяют другим скриптам использовать информацию, например, при каталогизации. Заголовки функций, как правило обеспечиваюся специальными блоками для строк в пределах 70 символов и меньше. В них описываются типы значений функции и значения нормального возврата.

Имена файлов. Лучший способ - подумать о том, как вы найдете файл через несколько месяцев. Часто достаточно коротких и ясных имен. Не забывайте, что имена файлов участвуют в директориях. Связывайте их с общими словами.

Примеры внедрений. Показывайте в скрипте примеры, как его быстро верифицировать и корректно использовать в других системах.

Отладка внедрений. Часто используется для построения отладочных функций как порт скрипта. Особенно в сети и для файлов, содержащих скрипты, которые посылают и записывают файлы для тестов. Такие тесты могут быть возможны с контрольными переменными в голове скрипта.

Минимизация глобалов. В больших скриптах и, вообще, где только возможно избегайте использовать глобальные имена, которые доставляют внешние выражения другим моделям и функциям. Это всегда практично для коротких скриптов, но помните, что короткий скрипт может каждый раз вызывать скрипт, который длиннее. Когда используете коллекцию глобальных переменных, то закрывайте отношения с используемыми объектами, которые держат треки.

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

Advertisement