Всем доброго дня.

Внезапно  возник "понедельничный" вопрос: если какие-то функции при разработке выделяются в расширения, то где хранить их описание "для потомков"?
По всей логике - должна быть "справочная информация" для  расширения, но... я ее не вижу.

Как документируют расширения многоуважаемые Мистчане?

Смотря для кого

У обработки и отчета и в Расширениях тоже имеется Справочная информация. Это первое.
И второе, можно добавлять макеты и указывать желаемый вид данных, вплоть до двоичных файлов.

Расширение удаляет данные, поэтому смысл их использовать в задачах сложнее чем поправить форму?

1. Справочная информация есть у конкретных объектов.
А если расширение затрагивает несколько объектов?

2. По принципам использования расширений. Расширения используются для упрощения дальнейших обновлений. В "моей" картине мира это выглядит так:

====

2.1 данные ВСЕГДА  добавляются в конфигурацию. Расширение данных не хранит (за исключением тиражируемых решений). Для нетиражируемых решений - хранение данных в расширениях на текущий момент считаю ересью.

2.2 формы, которые вряд ли изменятся в типовой - допустимо поправить в расширении "мышкой"

2.2 формы, которые вероятно изменятся в типовой - желательно править в расширении кодом

2.3 если функциональность хорошо обособляется - расширение предпочтительнее встроенного кода

2.4 процедурыи и обработчики, которые можно поменять без нарушения типовой логики (&после, &перед, &вместо+продолжитьвызов)  - меняем в расширениях.

2.5 процедурыи и обработчики, которые нельзя поменять без нарушения типовой логики  (надо вклиниваться в типовой код посередине)- предпочтительно менять внутри конфигурации, комментируя вставки и перенаправляя вызовы в свой общий модуль

2.6 если предыдущаие пункты безумно увеличивают сложность - забываем про них и делаем как проще

2.7 если предыдущие пункты существенно меняют производительность - забываем про них и делаем как быстрее работает

===

По существу вопроса.
Пока у меня есть 2 пути
1) сделать общий текстовый макет ИмяРасширения_Описание
2) добавить комментарии в модуль приложения

3) ????