ドキュメントには「設計者の意図」の説明が必要

オブジェクト指向でも関数型言語でも同じだけど、抽象化の方法は1つじゃないので、設計者が何を思って何をどう抽象化したのかという点がわからない。ドキュメントはこの点のみ必要だと思う

設計者の意図

引用元：http://quote-over100notes-jp.tumblr.com/post/170876102970