Реорганизация документации для повышения понятности

:white_check_mark: Обновление (4 июня 2024 г.): Первоначальная работа по реструктуризации тем документации завершена, новые категории уже доступны, а новые индексы показывают, что вы в них найдёте. Вы можете ознакомиться с ними здесь: Documentation - Discourse Meta — если заметите что-то неверное, пожалуйста, напишите об этом ниже!

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

Чего ожидать

:label: Новые категории

В дальнейшем наша документация будет категоризироваться и маркироваться в зависимости от описываемого действия или функциональности. Текущие группы, основанные на ролях пользователей, будут упразднены, и мы обновим все темы документации, указав, какая роль пользователя требуется для выполнения описанных действий.

:eyes: Временные визуальные изменения

В ходе этой реструктуризации вы можете заметить, что некоторые разделы документации выглядят немного неорганизованно или не на своих местах. Не волнуйтесь! Это временное явление, пока мы завершаем формирование новой структуры.

:white_check_mark: Всесторонние обновления

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

Как вы можете помочь

Как всегда, ваша обратная связь для нас бесценна. Если вы столкнётесь с какими-либо проблемами или у вас есть предложения по дальнейшему улучшению документации, пожалуйста, не стесняйтесь делиться своими мыслями в канале #site-feedback или в отдельном посте в этой теме.

Спасибо за ваше терпение в процессе внесения этих изменений!

14 лайков

Темы, касающиеся модерации, например Discourse Moderation Guide, относятся к категории Documentation > Site Management. Возможно, это стоит добавить в описание, так как в роли модератора я не стал бы искать подобные темы в категории для «владельцев и администраторов сайта».

3 лайка

Я внес небольшую правку в текст раздела «О нас», чтобы указать, что он также полезен для модераторов.

@JammyDodger и/или @hugh, возможно, выскажут дополнительные соображения, когда увидят это позже.

2 лайка

Я внёс небольшое дополнение:

4 лайка

Спасибо, что обратили на это внимание, @Moin!

@JammyDodger, ваше обновление выглядит хорошо.

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

Вы можете ознакомиться с ними здесь: Documentation - Discourse Meta — если заметите что-то неверное, пожалуйста, напишите об этом ниже!

1 лайк

Вы планируете добавить новые категории в плагин документации?

1 лайк

Мы колеблемся, стоит ли пробовать жизнь без плагина docs или нет. :slight_smile: Пока что я добавил новые категории в смесь. :+1:

3 лайка

Пост был объединен с существующей темой: Улучшенная навигация по документации с новой боковой панелью

Подскажите, пожалуйста, как формируется текст ссылок на темы в боковой панели при нахождении в подкатегории? С помощью ИИ?

1 лайк

У каждой подкатегории есть индексная тема, например: Using Discourse Index (ссылки на них размещены в описании в заголовке каждой подкатегории).

Боковая панель использует сокращённые заголовки оттуда, чтобы применять их вместо полных заголовков статей.

3 лайка