トピック
トピックとは、1つの目的を達成するために必要十分な情報を提供する、タイトルと本文から成る情報の単位
>トピックとは、1つの目的を達成するために必要十分な情報を提供する、タイトルと本文から成る情報の単位です。各トピックは独立しており、トピックが配置されるコンテクストに依存することなく、1つの完結した情報を読者に提供します。
>DITAによるマニュアル制作では、トピックが情報の編集と再利用の基本的な単位になります。仕様上は1つのファイルに複数のトピックを含めることができますが、実運用上は1つのファイルに1つのトピックを書くことが推奨されています。
>トピックはレイアウト情報を含んでいないため、様々なメディアへ変換できます。ただし、特定のメディアに依存するトピック(例えば、動画を含んだトピック)を作っても構いません。あるマニュアルに、メディアに依存するトピックを含める場合は、メディアごとにトピックの構成を変えて、出版物を生成することも可能です。
>トピックは1つの問いに対する1つの答えとして書きましょう
>トピックは文章として自立した内容として書きましょう
>これらの点をトピックの粒度を決める際に考えてみてください。
>トピックとは、1つの目的を達成するために必要十分な情報を提供する、タイトルと本文から成る情報の単位
Scrapboxの1ページが1トピックになる書き方を目指したい
関連