ドキュメントカテゴリーのホームページはどうあるべきか?

#documentation:site-managementをクリックしたときに、最新トピックではなく、インデックスに移動するべきだと思います。

あるいは、指定した何らかの「概要」トピックに移動するべきでしょうか?

カテゴリの説明でインデックスに直接リンクしていたのは、発見しやすくするためでした。

関連ディスカッション

あるいは、このままで良いのでしょうか?インデックスはすでにサイドバーにあるため冗長かもしれませんが、現在のデザインのどこか2点で少しおかしいと感じます。

  • インデックス自体を見つけるのが難しい場合がある
  • 最新トピック・リストが、特定のトピックに入った後のドキュメント閲覧の方法と比べて少し分かりにくい
「いいね!」 4

インデックスがドキュメントへのより良い入り口を提供するかどうか疑問に思います。私が思う問題は、インデックスページもサイドバーも、ドキュメントのトピックを実際にスキャンしてナビゲートしやすくしていないことです。

何か明白な解決策があるかどうかわかりません。既存のドキュメントプラットフォームには、より良いサイドバーレイアウトのパターンがあります。しかし、トピックの実際の整理にもっと時間をかけずに、これらは私たちのケースを改善するでしょうか?一般的なコミュニティウィキではうまく機能しないかもしれません。

現在の狭い左サイドバーではなく、目次のようなレイアウトを持つ右サイドバーの方がうまくいくかもしれません。

「いいね!」 3

meta.discourse.org とは別に、docs カテゴリプラグインの一般的な要件として、私もこの点について考えていました。インデックスページに到達する方が多くの場合より優れており、カテゴリに到達してトピックに入るまで変更されたサイドバーに気づかない可能性がある人と比較して、サイドバーの内容を明確にすると考えられます。

カテゴリごとに有効化できるプラグインのオプションがあれば素晴らしいです。ここで言及されているように、非常に長いリストがある場合には無効化し、他の場合には有効化できるようにするためです。

今日は少し詳しく調べました。カテゴリへの直接リンクを強制するトグルを追加するプルリクエストを作成するかどうか検討していたところ、現在進行中の機能の大幅な再構築に出会いました:FEATURE: Add visual doc category index editor by megothss · Pull Request #87 · discourse/discourse-doc-categories · GitHub

このような機能を実装するには絶好のタイミングのように思えますが、同時に、@sam がアップデート内で開発中の「シンプルモード」と競合する可能性もあります。サムさん、インデックストピックをカテゴリのホームとして使用するという選択肢は、あなたのシンプルモードに関する作業や、インデックス構築のためのより多くのオプションを提供するという大規模な作業に組み込めるものとお考えでしょうか?あなたが開発している簡易化されたカラム設定を選択できるか、あるいは単にインデックストピックを使用できるのであれば、それは本当に素晴らしいことだと思います。

「いいね!」 1