Кто какую нотацию использует для описания структуры кода?
Цель.
Есть определенный функционал который можно расширять. Есть ключевые процедуры в которые нужно добавлять вызов своих процедур и функций, для расширения функционала. Но есть основной "костяк" программы.
Мне нужно описать этот "костяк", и описать требование к API добавляемых функций. Если с описанием API хоть как-то понятно, то чем и как описывать костяк? Просто текстом тоже можно, но как-то не наглядно.
Кто какой нотацией пользуется для решения подобных задач?

jsdoc же

ну или чо там у тебя за езыг

BPWIN не подойдёт разве ?

что за костяк?
уже написанные вызываемые функции? - опиши как в СП примерно

(0) я использую понятие механизмов и их текстовое описание,
механизм выше процедуры и ниже подсистемы

(1) 1С :-)
(3) Это инструмент оперирующий большим количеством нотаций.
(4) Ну что-то наподобие своей библиотеки, но хочется передать ее содержимое в виде основных блоков, что-ли... Не хочется делать черный ящик. Хотя может действительно только основные блоки в виде квадратов описать.
(5) Вот, кстати, это идея. Спасибо.

(1) Интересно почему разрабы платформы не добавили теги для комментов чтобы можно было в 1С автоматом строить документацию?

(7) дык у них есть СППР и документация из неё строиться =)

(8) СППР хрень которая даже сами почти не используют, точнее из под палки

(9) не верю (с)

(10) так и есть, только для ERP и ниже, а для всяких розниц нет

(0) Тебе надо не код описывать, а перечислить все имеющиеся возможности для расширения и указать, куда писать код для каждого и какие должны соблюдаться требования.
Это надо на русском языке делать без вот этих всех fancy-pants-нотаций-шмонтаций

Ты просто не хочешь этого делать, по этому вместо того, чтобы начать писать, ищешь какую-то сферическую вундервафлю, которая либо сделает всё за тебя, либо сделает процесс интересным. Хрен тебе с коровью ногу: не будет такого. Работай.

Мануал по БСП же вон без всякого модного говна написан. Просто русский текст. Структурированный и последовательно изложенный с небольшими фрагментами кода.
Вот так и надо.