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

Ммм, не кажется ли кому-то, что ссылки в боковой панели выглядят слишком светлыми? Особенно в сочетании с мета-брендингом

2 лайка

Мне кажется, всё в порядке, и контрастность цветов соответствует стандарту WCAG уровня AA: https://webaim.org/resources/contrastchecker/?fcolor=646464&bcolor=FFFFFF.

Однако у всех разные потребности — вам трудно читать этот текст?

1 лайк

Тогда это, вероятно, моя проблема. Это как-то отвлекает меня… возможно, только меня.

1 лайк

Если кто-то ещё чувствует то же самое, мы можем копнуть глубже и попробовать другие контрасты.

Это отлично использует боковую панель. Раньше у нас был плагин, который выполнял аналогичную функцию, но он добавлял дерево документации только в заголовок. Для этой цели боковая панель подходит гораздо лучше.

С точки зрения пользовательского опыта (UX) всё работает хорошо. Единственное, чего мне не хватает, — это полного «дерева» в боковой панели.

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

Если вы перейдёте, например, в раздел «Общее использование», должна быть возможность подняться на уровень выше (к корню Documentation). Возможно, под ссылкой ← Назад на форум можно было бы добавить ссылку вроде ← Назад к главной документации.

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

4 лайка

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

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

4 лайка

У меня есть предложение для этой новой боковой панели.
Добавьте в нижней части систему вкладок. Это позволит переключаться между боковой панелью документации и обычной боковой панелью. Вам не придётся ждать загрузки страницы. Я представляю это так:

[документация][форум/общее][меню администратора?]
[фильтр]
[руководства]
[темы/настройка]

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

3 лайка

Как мне добавить туда иконку? У меня её нет.

Что было бы лучше или проще (это не совсем одно и то же) для создания ссылок в боковой панели? Ручной труд… не вариант :joy:

Я использовал ИИ для этого, и он справился довольно хорошо. Но проблема в OpenAI, потому что их модели ленивы и довольно часто отказываются генерировать списки длиннее 20 пунктов. Я не могу, да и не хочу, отказываться от OpenAI — в основном потому, что тогда мне пришлось бы менять так много всего.