Oder sollte es Sie zu einem anderen von Ihnen festgelegten „Übersichts“-Thema führen?
Wir haben in den Kategoriebeschreibungen direkt auf den Index verlinkt, um ihn auffindbarer zu machen:
verwandte Diskussion
Oder ist es so in Ordnung, wie es ist? Vielleicht ist das redundant, da der Index bereits in der Seitenleiste vorhanden ist, aber irgendetwas fühlt sich bei dem aktuellen Design in zweierlei Hinsicht etwas seltsam an:
der Index selbst kann schwer zu finden sein
die Liste der neuesten Themen fühlt sich etwas desorientierend an im Vergleich dazu, wie das Durchsuchen von Dokumentationen funktioniert, sobald man sich in einem bestimmten Thema befindet
Ich frage mich, ob der Index einen besseren Einstieg in die Dokumentation bietet. Das Problem, das ich sehe, ist, dass weder die Indexseite noch die Seitenleiste es einfach machen, die Dokumentationsthemen tatsächlich zu überblicken und zu navigieren:
Bin mir nicht sicher, ob es eine offensichtliche Lösung gibt? Es gibt Muster für bessere Seitenleistenlayouts von bestehenden Dokumentationsplattformen. Aber würden diese unseren Fall verbessern, ohne mehr Arbeit an der tatsächlichen Organisation der Themen zu leisten? Sie funktionieren möglicherweise nicht gut für das Community-Wiki im Allgemeinen.
Vielleicht würde eine rechte Seitenleiste, die eher dem Layout eines Inhaltsverzeichnisses entspricht, anstatt der derzeitigen schmalen linken Seitenleiste, besser funktionieren?
Ich habe darüber auch nachgedacht, unabhängig von meta.discourse.org, aber als allgemeinen Bedarf für das Plugin „docs categories". Das Erreichen der Indexseite ist in vielen Fällen viel besser, und ich denke, es würde den Inhalt der Seitenleiste für Nutzer klären, im Vergleich dazu, direkt in einer Kategorie zu landen und die geänderte Seitenleiste wahrscheinlich erst zu bemerken, wenn man sich in einem Thema befindet.
Eine Option im Plugin, um dies für eine Kategorie zu aktivieren, wäre großartig. So könnte man es in Fällen mit extrem langen Listen, wie hier erwähnt, deaktivieren, aber in anderen Fällen aktivieren.
Ich habe mich heute etwas tiefer damit beschäftigt – ich habe überlegt, ob ich einen Pull Request erstellen möchte, um eine Einstellung für das Plugin hinzuzufügen. Wenn diese Einstellung aktiviert ist, würden direkte Links zur Kategorie den Browser zur Dokumentations-Indexseite dieser Kategorie weiterleiten. Bei der Durchsicht bestehender Arbeiten am Plugin bin ich auf eine viel umfassendere Überarbeitung der Funktionen gestoßen, die gerade läuft: FEATURE: Add visual doc category index editor by megothss · Pull Request #87 · discourse/discourse-doc-categories · GitHub
Es scheint ein guter Zeitpunkt zu sein, diese Art optionaler Funktionalität hinzuzufügen, bei der der Dokumentations-Index als Kategorienliste verwendet wird. Gleichzeitig könnte dies mit einem „Simple Mode" kollidieren, den @sam im Rahmen des Updates entwickelt. Sam, siehst du die oben beschriebene Option als etwas, das in deine Arbeit am Simple Mode oder in die umfassenderen Arbeiten im PR passt, um mehr Möglichkeiten zum Erstellen des Index zu bieten? Es wäre wirklich großartig, entweder das von dir entwickelte vereinfachte Spalten-Layout wählen zu können oder einfach das Index-Thema zu nutzen. Vielleicht sogar idealerweise, dass der Inhalt des Beitrags oberhalb der vollständigen, normalen oder einfachen Auflistung der Kategorie angezeigt wird.