Графический вывод мест для встройки виджетов

[gromdron]

На странице "Встраивание приложений" есть очень хорошая механика с визуальных отображением всех существующих виджетов:

Очень часто бывает необходимость быстро посмотреть какие места встройки есть в одном месте со скриншотами и мне кажется страница встройки (api-reference/widgets/placements.html) очень для этого подходит.

В diplodoc даже есть подобный синтаксис с разъяснением - https://diplodoc.com/docs/ru/syntax/term

[serg-vostrikov-bitrix]

Ну, не могу пока согласиться. Что это за частая потребность просматривать одно и то же в виде полного списка?

При первом знакомстве, когда человек в принципе не знает, какие места встройки есть, мы ему даем ключевые инструменты и конкретные места встройки в навигации

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

В общем, пока кажется, что это какой-то индивидуальный паттерн работы с документацией, сложившийся в силу использования старой доки

[gromdron]

Что это за частая потребность просматривать одно и то же в виде полного списка?

Достаточно часто (статистику не веду, но пару раз в месяц запрос в том или ином источнике возникает). Формулировка следующая "где посмотреть все места куда можно встроиться" и данная страница закрывает их очень хорошо:

• Нет необходимости переходить на каждую страницу чтобы увидеть что это за встройка (где она отображается)
• Пока проблемы с левым меню, при переходе на страницу левый блок виджетов находится глубоко внизу
• страница со списком "всех" точек встроек внезапно не покрывает "все" точки встроек

Когда он уже решает конкретную задачу, ему тем более нет нужды бегать по полному списку, он точно понимает контекст.

Зачастую конкретная задача звучит не как "в этом месте добавить встройку", а есть такой-то пользовательский процесс и его нужно как-то "красиво" вызвать из карточки Н. Как бы это сделать.
В данном случае - страница на которой можно видеть все встройки в карточку Н приоритетнее раздела где можно попереключаться между страницами.

В общем, пока кажется, что это какой-то индивидуальный паттерн работы с документацией, сложившийся в силу использования старой доки

Не отрицаю - обычно на вопрос "где посмотреть" отправляю на данную страницу (со списком всех встроек) чтобы человек наглядно посмотрел куда можно встроиться.

[serg-vostrikov-bitrix]

Подумаем. Пока кажется, что это просто привычка 😀

[voronrk]

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