情報の階層構造を意識する
人に何かを伝えるとき、ドキュメントを書くときなんかに、伝えようとしている内容の階層構造を意識して整理することが重要だと、最近改めて思っております。
どういうこと?端的に言うと、わかりやすく話を伝えるために、内容における項目の分類(=抽象化)と、それぞれに付随する要素の配置を適切に行い、内容全体を整理することだと思っています。
例えば、「hogeとfugaは同じAタイプの具体的な例として括れるよね。でもfooはそれらとは違うBタイプだよね」という場合、マークダウンだと、下記