JavaScriptおれおれAdvent Calendar 2014 – 17日目 特にライブラリー的なものを作るとき、最初にドキュメントを書くようにしてます。 例えばこれ、まだドキュメントしかないです。 ginpei/scroller.js 最初にドキュメントを書く効能 もちろん後で書く手間が省けるってのもあるけど、それより、最初にAPIのリファレンスを作る事で、成果物の最終形が明確になります。最終形が分かっていれば、ごりごり書いてそれに近づけるだけっすね。 APIが決まっていれば試験を書ける、試験が書ければリファクターができる、リファクターができれば雑なコードでも実装を進められる。とまあそんな感じ。 もしここで明確な最終形を記述できなかったとしたら、それは現時点ではまだ何を作れば良いかわかっていないという事になるでしょう。それだとコードも書けない。 モジュールでも同じように 製品内の部