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

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

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

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

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

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

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

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

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

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

:question: Почему это изменение?

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

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

:derek_pointing: Мы нуждаемся в вас!

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


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

10 лайков

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

4 лайка

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

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

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

5 лайков

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

3 лайка

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

3 лайка

Да — вы можете использовать in:docs, и поиск будет охватывать темы в Documentation и Wiki одновременно.

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

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

2 лайка

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

5 лайков

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

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

4 лайка