Conversation

ドキュメントが更新されない理由としては、評価のポイントになりにくいというのもあるし、コードとドキュメントの距離が遠すぎるというのもあると思う

自分はコードを修正した後、同じレポジトリの README.md 、docs/ 以下を「次のコミット」で更新するようにしてる。時間が経つと分からんようになるからね。

が、意外とgodoc などコード内ドキュメントは触ってなくて、これはなんとかしなくてはいけないなぁとは思ってる
（が、コードを無駄に修正を入れると、rebase や blame の障害になる場合があるので、あんまりやりたくない気持ちもある）