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

[mcwumbly (Dave McClure)]

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

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

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

関連ディスカッション

@manuel

@hellekin

しかし、サブウィキの「インデックス」リンクは、インデックス・トピックではなくカテゴリに移動します（少なくとも「開発者ウィキ」の場合はそうです）。これにより、<kbd>Ctrl</kbd>+<kbd>f</kbd>できるワンショット・リソースにアクセスするために、さらにクリックが必要になります。

それは現在のデフォルトのカテゴリ・ボックスの動作です。おそらくデフォルトの動作を変更することは可能です。しかし、ドキュメント・カテゴリでの意図されたエクスペリエンスは何なのかと思います。インデックスは、カテゴリ・バナーを念頭に置いて追加されたように見えます。カテゴリ・ボックスではなく、次のとおりです。

同時に、インデックス・トピックはトピック・リストの最上部に固定されたままで、インデックス・トピックが読まれても自動的にピン留めが解除されません。そのため、このインデックスをかなり重複させています。まず、サイドバー・メニューを生成するために意図されています。次に、トピック・リストの最上部にピン留めします。次に、表示されるカテゴリの説明にそのトピックへのリンクを追加します。

ドキュメント・カテゴリの説明からリンクを削除できると思います。

@mcwumbly

@manuel

同時に、インデックス・トピックはトピック・リストの最上部に固定されたままで、インデックス・トピックが読まれても自動的にピン留めが解除されません。

うーん…私の経験ではそうではありません。

しかし、もしそれが私にそのように機能していたなら、これらの説明にインデックスが表示される必要性はそれほど感じないでしょう。

いずれにせよ、これはリンクが新しいドキュメント・プラグインのユーザビリティのギャップを埋めるための回避策であることを明確にしています。

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

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

[manuel (Manuel Kostka)]

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

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

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