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