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

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

>トピックの粒度はどのように決めるのでしょうか。
>トピックは1つの問いに対する1つの答えとして書きましょう
>トピックは文章として自立した内容として書きましょう
>トピックは再利用できるように書きましょう
>これらの点をトピックの粒度を決める際に考えてみてください。

>トピックとは、1つの目的を達成するために必要十分な情報を提供する、タイトルと本文から成る情報の単位
なるほどmeganii
Scrapboxの1ページが1トピックになる書き方を目指したい
豆論文も同じような考え方なんだろうか

関連