Стоит ли чаще использовать формы-заполнители в темах документации?

Заставило меня задуматься, что Meta отчасти является платформой для документации.

Поиск по example.discourse.com в документации выдаёт 46 результатов (и другие темы могут использовать другой домен).

Эти темы могли бы выиграть от использования плейсхолдеров. Пример темы с множеством упоминаний discourse.example.com: Discourse Doc Categories

Как насчёт использования placeholder-forms в этих темах?

5 лайков

100% согласен с @Canapin! Я большой поклонник компонента placeholder-forms и использую его во всех своих личных и корпоративных Discourse-форумах для документации, создания Runbooks и для полувтоматизации процессов, которые ещё не готовы для Bash-скриптов.

Вот пример с использованием Placeholder: Publishing a Material for MkDocs site to Azure, with automatic branch/PR preview deployments - blog - Baw Medical Ltd

Мне бы очень хотелось видеть статьи в Documentation > Self-Hosting и #community-wiki:sysadmins, где используются placeholder-ы везде, где есть текст или команда, требующие индивидуальной настройки в реальном времени с вводом пользователя.

4 лайка

Мне также нравится компонент-заполнитель. Use a subfolder (path prefix) to serve Discourse with multiple servers sharing a domain — пример, где он уже используется, и заполнитель также работает в автоматическом переводе (по крайней мере, в немецком; я немного опасался, что ИИ может нарушить форматирование).

Я бы также хотел видеть иконку Discourse чаще, вместо крошечных скриншотов иконки или использования похожего эмодзи.

3 лайка