箇条書きより見出しを好め - koicの日記Wiki や esa なんかでひたすら箇条書きで記されているのを、最近たびたび見かけるようになった気がしたので話していた、文書構造のリファクタリングテクニックとなる。 基本は一番浅い箇条書きを大見出しにして、ネストを一段ずつ下げるといったものでざっくり以下のような図解で話していた。以下の例では大見出しになったものをタイトルとしており、中見出しが一番浅い箇条に対応している。初手としてはかなり手早く手を加えることのできるテクニックのひとつだと思う。 もちろん箇条書きが良くないといったものではなく箇条として成立していればよい。良くないのは箇条の重ね書きの結果として、箇条書きの4段ネストといったものなどで、それは既に箇条として破綻していたりする。そういった structure smell を作らないように積極的に見出しを導入しておくのがひとつの解だと思っている。 広く普及していると思われる Mar
