Стандарты, которые делают
код 1С читаемым
Единые правила документации, структуры, именования и надёжности. Не догадки команды, а проверяемый контракт.
От документации до контроля качества
Начните с XML-дока и SyntaxMarks, затем закрепите структуру модуля, нейминг и наблюдаемость.
XML-док
Единый XML-подобный контракт для параметров, результата, сложности и примеров функции.
Открыть стандарт →Визуальная карта кодаSyntaxMarks
Маркеры, которые помогают быстро распознавать роль строки в XML-доке и BSL-коде.
Открыть стандарт →Исполняемый контекст операцииIntention Block
Короткая строка ib делает намерение функции видимым и пригодным для логов и сообщений.
Открыть стандарт →Предсказуемая структура модуляРегионы и примеры
Карта регионов, размещение экспортных функций, тестов и длинных прикладных сценариев.
Открыть стандарт →Контролируемая цена ветвленияСложность
Как считать цикломатическую сложность, где ставить пороги и что проверять в CI.
Открыть стандарт →Имена как часть контрактаСтиль именования
Правила для функций, параметров, модулей, регионов, префиксов и суффиксов.
Открыть стандарт →EN-канон и RU-эргономикаНейминг и алиасы API
Как давать удобные русские алиасы, не меняя поведения и публичного API.
Открыть стандарт →Наблюдаемое выполнениеЛогирование и ошибки
Единые уровни, сообщения, валидация параметров и обработка исключений.
Открыть стандарт →Три правила, которые видны сразу
- 01Документируйте контрактXML-док хранит параметры, результат, сложность и пример рядом с функцией.
- 02Показывайте роль строкиSyntaxMarks превращают длинный модуль в визуально читаемую карту.
- 03Фиксируйте намерениеIntention Block и MILA объясняют решение, а не повторяют синтаксис.