Описание:
При использовании функции генерации описания метода с помощью FastCodeAPI директивы компиляции (&НаКлиенте, &НаСервере, &НаСервереБезКонтекста, &НаКлиентеНаСервере) перемещаются выше блока описания, что нарушает привычную структуру кода.
Текущее поведение:
&НаКлиенте
// Описание метода
//
// Параметры:
// Параметр1 - Тип - описание
//
Процедура МойМетод(Параметр1)
Ожидаемое поведение:
// Описание метода
//
// Параметры:
// Параметр1 - Тип - описание
//
&НаКлиенте
Процедура МойМетод(Параметр1)
Директивы компиляции логически относятся к методу, а не к его описанию, и должны располагаться непосредственно перед объявлением процедуры/функции согласно стандартам оформления кода 1С.
Предлагаемое решение:
При генерации описания через FastCodeAPI скрипт должен определять наличие директив компиляции и вставлять описание между директивой и объявлением метода, не перемещая директиву выше.