Экспортные переменные должны содержать описание

Имена переменных назначаются согласно общим правилам образования имен переменных.

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

Экспортные переменные без описания - двойное зло, т.е. использование этих переменных в других модулях становится неочевидным.

Подозрительный код

Перем КоличествоТаблиц Экспорт;

Исправленный код

Перем КоличествоТаблиц Экспорт; // количество таблиц, необходимых для решения задачи

См. также

• ИТС: Структура модуля
• ИТС: Описание процедур и функций
• ИТС: Использование переменных в программных модулях
• Правило: Переменные должны содержать описание
• Правило: Экспортные процедуры/функции должны содержать описание

Экранирование кода

// sonar:ExportVariableWithoutDescription:off
// sonar:ExportVariableWithoutDescription:on