アカウント名:
パスワード:
「ソースがドキュメントだ」、「仕様書？なにそれおいしいの」の世界だし。
オープンソースなら一般的に多数の人間の査読が入るので、読みにくければ修正を迫られるか、もしくは勝手にforkして読みやすく修正されるので、仕様書がなくてもなんとかなるんです。
それに対して企業内などで開発される(クローズドな)ソースコードの場合、少数または1人のセンスのみで作られることが多く、本人にしかわからないことが多数残るばかりか、「きちんと動いているんだから修正するな」の意識が大きく、読みやすく直せない場合が多々あります。こういう場合は別途仕様書を起こす必要があります。
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
アレゲは一日にしてならず -- アレゲ研究家
でも、オープンソースってそんなもんじゃね？ (スコア:1)
「ソースがドキュメントだ」、「仕様書？なにそれおいしいの」の世界だし。
Re:でも、オープンソースってそんなもんじゃね？ (スコア:0)
オープンソースなら一般的に多数の人間の査読が入るので、読みにくければ修正を迫られるか、
もしくは勝手にforkして読みやすく修正されるので、仕様書がなくてもなんとかなるんです。
それに対して企業内などで開発される(クローズドな)ソースコードの場合、
少数または1人のセンスのみで作られることが多く、本人にしかわからないことが多数残るばかりか、
「きちんと動いているんだから修正するな」の意識が大きく、読みやすく直せない場合が多々あります。
こういう場合は別途仕様書を起こす必要があります。