TL;DR

• 本当に必要なのはドキュメントなのか考えましょう

Living Documentation

• 納得した資料（client-side-ddd-on-github）
  • 良いドキュメントには自動化が必要
  • 最も良いドキュメントはno document

リーダブルコード

• 過去ログ
• コメントは領域に対する情報の比率が高くなければならない

自分の考え

• ドキュメントを書くつもりでテストを書く

• Doc Test不要論

  • 動かせるのでメンテナンスはされている（Good）
  • ソースコードよりも長いテストを書くことは珍しくない
  • ソースの情報が増える、が情報の比重が高いとは限らない
    • それなら綺麗にテストを書く

• ドキュメント生成

  • JSDoc, esdoc
  • FlowType, TypeScript の型定義ファイルなどの登場によりその役割は不要になりつつある気持ち
  • ソースコードの情報比率の高まりも重要
    • 可読性
    • 補完

• 動いているものには価値が高い

  • storybook
  • style guide

• 使い始めるための最短ルート

このエントリーの価値

読まれなければ意味がない。