仕様書
「ぱどタウン」の仕様書(のようなもの)を作る必要がでてきた。
「資産」として管理しなければならない、とか、これから「外部」とあれこれということらしい。
ちなみに、CGIは、200個、(あまりオブジェクト指向でない)モジュールが40個ありました。
ふと、思い出すのが、この記事。
はてなの開発は社長を含めたエンジニア4人体制で、「朝は立ったままミーティング」「仕様書はなく、ソースそのものが仕様書」といった独特のコンセプトを持つ。
「ぱどタウン」の仕様書がないのは、ほぼ1人で作った物だから。自分でわかればよかったから。
それが、3年と半年たって、「仕様書」と言われても困るわけだ。
恥ずかしい話だが、専門でもないままこの仕事に関わって、仕様書という物を書いたことがない。動いている物、出来た物が仕様。さらに苦手。
そんなだから、そもそも何を書けばいいのかわからない。プログラマが二人になった今も、コンパイルされているものは、1つもないのだから、ソース見ればいいじゃん状態。
っていうか、ソース嫁。
とりあえず、「資産」用に、treeコマンドでファイルのリストを出力してコメントつけるところから始めるつもりです。
良い方法があれば教えてください。