ドキュメント：1つの長いページまたはいくつかの短いページ
ドキュメントのデザインと整理に取り組んでいます。現在の構造は次のようなものです：
- トピックに関する一般情報
- 専門サブトピック1
- 専門サブトピック2
- 専門サブトピック3
（「トピックに関する一般情報」自体はより広範なトピックの下にネストされているため、「専門のサブトピック1」は第3レベルにありますが、マークダウンでそれを表すことはできません。）
問題は、この複数ページのネストされたフォーマットを維持するか、すべてのコンテンツを1つのページにまとめ、上部に目次を表示するかです。
ジャーナリストとしての私の以前の経験は、読者があなたのコンテンツ部分（したがって私たちの現在の組織）が長くなるほど低下することを教えてくれました。しかし、私は物事が紙に書かれたパラダイムから少し変わったかもしれないことを認識しています。私はいくつかの調査を試みましたが、私が見つけたもののほとんどは、はるかに商業的な文脈（「すべての広告をスクロールせずに見える範囲に置かないでください」など）または約 infini -scroll 。 この質問 主題に触れますが、私が必要としていることについては完全には触れていません。
それで、長いマルチトピックドキュメントページ、または短いトピック固有ページ？私は研究と統計を望んでいますが、逸話的な経験で落ち着きます。
以前の結論に同意した。ただし、複数の短いトピックがある場合は、ユーザーが1つのトピックから別のトピックにすばやく移動できるようにしてください。
そのため、明確で目に見えるメニュー、検索、分類、下部の推奨トピック、次の/前のトピック、および適切と思われるその他のタイプのナビゲーションを用意すると役立ちます。
Reactまたは類似のテクノロジーでリアルタイム応答サイトを使用すること、または一般に非常に速い応答時間を使用することは、多くの助けにもなります。
どちらも。
たとえば、 MySQLリファレンスマニュアル は多くの小さなページに分割されていますが、さまざまな形式でテキスト全体へのリンクも提供しています。これは、費やすよりも手間がかかる場合がありますが、HTMLとしてのページ全体へのリンクの提供は非常に簡単です。
私にとって、小さいページを読むことは、それが許す限り常にずっと良いです
- 新しいブラウザタブで詳細を開く
- ブックマークとパーツへのリンク
さらに、読み込みがはるかに速く（*）、スクロールバーを誤ってクリックしても迷うことはありません。
とにかく、いくつかのグローバル検索がうまく機能することを確認する必要があります。私は通常、グーグルに依存しています。これは、プライベートページでない限り、最適に機能します。
（*）理想的には、次のページとリンクされたページをプリフェッチします。
以前の経験は正しいことを教えてくれます:)データの読み取りと視覚化に関するHPの記事によると、人々は自分が読んだものの20％（そして自分が行ったり見たりしたものの80％）しか取り入れていません。
https://policyviz.com/wp-content/uploads/2015/10/power-of-visual-communication.pdf
したがって、私が読者である場合、各トピックに複数の、しかし簡潔で短い段落またはページを用意することを望みます。おそらく、グラフィックにそれらを含めて、気にせずにすぐに取り込める例を示すことができます。
お役に立てれば。
短い答えは（よくあることですが）「ユースケースに依存します」でしょう。特に、ドキュメントにアクセスするためにどのようなアフォーダンスが重要になるかを考える必要があります。
テキストを扱いやすいサブセクションに分割することは、文学では chunking と呼ばれ、かなり広範囲にわたって研究されてきました。実用的な意味を持つそのような研究のいくつかの例については、 これらの記事 を参照してください。
チャンクがそれぞれ個別にロードする必要がある別々のページに表示されるのか、それともセクションとアンカーが含まれる長いページに表示されるのかは、データのユースケースに依存する後続の問題です。それぞれの明らかな利点がいくつかあります。 Webにはさまざまなアプローチがありましたが、 単一ページのアプリケーション は明らかに顕著な傾向であり、問題の範囲を示しています。ここに、私が重要だと考えるいくつかの側面があります。
単一ページ
ユーザーがオフラインで使用するためにドキュメントをダウンロードまたは印刷することを期待している場合は、単一のページが推奨されます。次に、トピックの数に依存しない数回のクリックでこれを実行できます。
単一のテキストのもう1つの利点は、参照に使用される場合です。次に、ほとんどの読み取り環境でctrl+fを使用してテキスト全体を簡単に検索できます。
欠点は、リンクに記載されている「トップに戻る」ボタンですが、実際の問題は、目次に継続的に簡単にアクセスする必要があることです。
複数ページ
最初から最後まで読みたいセクションがある場合は、複数のページを使用することをお勧めします。これにより、トピック/セクションをすべて読んだことで、ユーザーがトピック/セクションを「閉じた」と認識できます。
一部のページは非常に短くてほとんど空白に見えない場合や、他のページはスクロール自体が長いページのように見える場合があるため、一般的なリーダーの画面サイズに注意する必要があります。
また、良好な接続性が必要になることもあり、これは（モバイルでは、移動中）容易に利用できない場合があります。
その場合、検索機能はリーダーデバイスによって提供されるものとして提供されず、Webプラットフォームから使用できる必要があります。