Or maybe it should being you to some other “overview” topic you specify?
We had been linking to the index directly in category descriptions to make it more discoverable:
related discussion
Or maybe it’s fine as is? Perhaps that’s redundant given that the index is already in the sidebar, but something feels a bit off to me about the current design in two ways:
the index itself can be hard to find
the latest topic list feels a bit disorienting compared with the way browsing documentation works once you’re in a given topic
I wonder if the index gives a better entry to the documentation. The problem I see is that neither the index page nor the sidebar make it easy to actually scan and navigate the documentation topics:
Not sure if there’s an obvious solution? There are patterns for better sidebar layouts from existing documentation platforms. But would these improve our case without doing more work on the actual organization of topics? They might not work well for the community wiki in general.
Maybe a right sidebar that has more of a table of content layout, rather than the current narrow left sidebar, would work better?
Я тоже об этом думал, отдельно от meta.discourse.org, но как общую потребность для плагина категорий документации. Переход на главную страницу во многих случаях гораздо лучше, и, я думаю, это прояснит содержимое боковой панели для пользователей по сравнению с переходом непосредственно в категорию, где они, скорее всего, не заметят изменений в боковой панели, пока не откроют тему.
Было бы здорово иметь в плагине опцию для включения этого функционала для конкретной категории, чтобы в случаях с чрезвычайно длинными списками, как упоминалось здесь, можно было отключить его, а в других — включить.
Я сегодня немного глубже изучил этот вопрос — я размышлял, стоит ли создать pull request для добавления настройки в плагин. При включении эта настройка заставляла бы прямые ссылки на категорию перенаправлять браузер на индекс документации для этой категории. Изучая существующую работу над плагином, я наткнулся на гораздо более масштабную переработку функций, которая сейчас находится в процессе: FEATURE: Add visual doc category index editor by megothss · Pull Request #87 · discourse/discourse-doc-categories · GitHub
Кажется, это отличное время для добавления такой опциональной функциональности, позволяющей использовать индекс документации в качестве списка категорий. В то же время это может вступить в конфликт с режимом «Простой» (Simple Mode), который @sam разрабатывает в рамках обновления. Сэм, видишь ли ты описанную мной опцию как что-то, что могло бы вписаться в твою работу над режимом «Простой» или в более масштабную работу в PR по предоставлению дополнительных вариантов построения индекса? Было бы действительно здорово иметь возможность выбирать упрощённую настройку столбцов, которую ты разрабатываешь, или просто использовать тему индекса. Возможно, в идеале содержимое поста отображалось бы выше полного, обычного или упрощённого списка категории.
