トピック

トピックとは、1つの目的を達成するために必要十分な情報を提供する、タイトルと本文から成る情報の単位です。各トピックは独立しており、トピックが配置されるコンテクストに依存することなく、1つの完結した情報を読者に提供します。

DITAによるマニュアル制作では、トピックが情報の編集と再利用の基本的な単位になります。仕様上は1つのファイルに複数のトピックを含めることができますが、実運用上は1つのファイルに1つのトピックを書くことが推奨されています。

トピックはレイアウト情報を含んでいないため、様々なメディアへ変換できます。ただし、特定のメディアに依存するトピック（例えば、動画を含んだトピック）を作っても構いません。あるマニュアルに、メディアに依存するトピックを含める場合は、メディアごとにトピックの構成を変えて、出版物を生成することも可能です。

トピックの粒度はどのように決めるのでしょうか。

トピックは1つの問いに対する1つの答えとして書きましょう

トピックは文章として自立した内容として書きましょう

トピックは再利用できるように書きましょう

これらの点をトピックの粒度を決める際に考えてみてください。

トピックとは、1つの目的を達成するために必要十分な情報を提供する、タイトルと本文から成る情報の単位

Scrapboxの1ページが1トピックになる書き方を目指したい

関連