Новые страницы для официальной и сообщественной документации

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

:writing_hand: Официальная документация

Мы обновили категорию Documentation, чтобы она была посвящена исключительно официальной документации. Это означает, что весь контент в её подкатегориях поддерживается членами команды Discourse, что гарантирует точность и актуальность информации. Если вы ищете наиболее авторитетные руководства и справочные материалы — вам сюда!

Почему только члены команды?

Ограничение создания и редактирования официальной документации только членами команды обеспечивает последовательность и надёжность. Наша цель — предоставить точные и хорошо поддерживаемые ресурсы для всех: от новых пользователей до опытных разработчиков. Все участники сообщества по-прежнему могут отвечать в этих темах, чтобы обсудить контент или предложить изменения.

:people_hugging: Вики сообщества

Не переживайте — для ваших вкладов тоже найдётся много места! Вся документация, созданная сообществом, теперь доступна в категории #community-wiki. Именно здесь объединяются опыт, советы и коллективные знания нашего активного сообщества.

Кто может вносить вклад?

Пользователи с уровнем доверия 2 и выше могут создавать и редактировать темы в #community-wiki. Это даёт опытным пользователям возможность делиться своими знаниями, обогащая и разнообразя ресурсы нашего сообщества. Это также означает, что доверенные участники сообщества могут редактировать любую документацию сообщества, если обнаружат в ней ошибки или устаревшую информацию.

:question: Почему такие изменения?

Данная политика призвана сбалансировать необходимость в официальной, поддерживаемой документации и ценный вклад нашего сообщества. Она также обеспечивает чёткую структуру для пользователей, ищущих информацию — независимо от того, нуждаются ли они в официальном руководстве или советах сообщества.

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

:derek_pointing: Нам нужна ваша помощь!

Вики сообщества уже имеет преимущество в виде прочной, управляемой сообществом площадки для обучения и обмена знаниями, и мы будем рады получить ещё больше ваших предложений. Если у вас есть отличные руководства, примеры конфигураций или советы — категория #community-wiki ждёт вашего вклада!


Эту политику документации можно найти в её постоянном месте здесь:

10 лайков

Подскажите, пожалуйста, что произойдёт с бейджем «Писец»?

4 лайка

Существует ли простой способ искать одновременно в обоих источниках документации? Я знаю, что можно искать по нескольким категориям, но это более неудобно, чем просто добавить «Documentation» с помощью автодополнения.

Думаю, я могу использовать in:docs, так как обе категории добавлены туда? in:kb, который тоже работал для Discourse Docs, похоже, не работает.

А как это работает для подкатегорий? Например, как искать всю информацию, написанную для пользователей? Могу ли я искать одновременно в #community-wiki:users и Documentation > Using Discourse?

5 лайков

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

3 лайка

Значок «Писец» обновлён и теперь охватывает вклад в вики-сообщество :slight_smile:

3 лайка

Да — вы можете использовать in:docs, и это выполнит поиск тем одновременно в Documentation и #community-wiki.

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

Для этого нужно указать categories:users,using-discourse в поиске.

2 лайка

Но все они требуют довольно глубоких знаний Discourse, так как ни одна из них не поддерживается в интерфейсе расширенного поиска. Разве документация не должна быть максимально удобной для поиска?

5 лайков

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

Это открывает отличную возможность и служит дополнительной мотивацией для работы над подобными обновлениями, так что посмотрим, что мы сможем сделать! Мы обсудим это, и я вернусь сюда с любыми новостями.

4 лайка