РУБРИКА «ЧёПоСтандартам»
Тексты модулей и Оформление текстов запросов

Казалось бы "комментарии", что про них может быть в стандартах, но не тут-то было.

#std456

3. Программные модули не должны иметь закомментированных фрагментов кода ...
...
Неправильно в текстах запросов использовать комментарии для их модификации  
Пример: ТекстЗапроса = СтрЗаменить(ТекстЗапроса, "// ПОМЕСТИТЬ", "ПОМЕСТИТЬ");
...
7.2. Небольшие комментарии пишутся в конце строки
...
7.3. Большие комментарии или комментарии к фрагменту кода пишутся перед комментируемым кодом в отдельной строке. ... Между символами комментария "//" и текстом комментария должен быть пробел.

Более подробно вы можете почитать по ссылке в шапке поста, а я постарался подсветить важные моменты.

И есть одна важная особенность, по поводу комментирования в текстах запросов, поэтому укажу ещё один стандарт:

#std437

4. В запросы, сложные для понимания, в которых используются вложенные запросы, объединения или соединения рекомендуется вставлять комментарии...
При этом необходимо иметь в виду, что при использовании конструктора запросов, все комментарии в запросе удаляются автоматически без предупреждения.

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

P. S. Или имелся в виду вариант, что не используйте конструктор запроса🤔, что думаете? 💬

#ЧёПоСтандартам