アカウント名:
パスワード:
開発者が書かないでいる以上は、だれかがソースから解読してドキュメントを起こすしかないんだろうなあ。読めても書けない人はそういう貢献もあるねってことで。
そろそろどっかの天才が「ソースを食わせるとドキュメントを吐き出してくれるソフトウェア」というのを発明してくれないものか。
ドキュメントと一言で扱われることが多いけど、階層や想定読者で違うよね。
このコメント [srad.jp]で言われているような、ポリシーや方針みたいな大雑把なものから、動作オプションの影響範囲と差、さらに細かくは関数の引数の意味、みたいなものまで。
ドキュメントを出せ、は「俺が知りたいことが 1ページで書いてある資料をだせ」なことも多くて、結局 google だったりする。 (私はお前のおかあさんじゃない)
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
アレゲはアレゲを呼ぶ -- ある傍観者
ソースから (スコア:2, 興味深い)
開発者が書かないでいる以上は、だれかがソースから解読してドキュメントを起こすしかないんだろうなあ。
読めても書けない人はそういう貢献もあるねってことで。
Re: (スコア:0)
そろそろどっかの天才が「ソースを食わせるとドキュメントを吐き出してくれるソフトウェア」というのを発明してくれないものか。
Re:ソースから (スコア:3, すばらしい洞察)
ドキュメントと一言で扱われることが多いけど、階層や想定読者で違うよね。
このコメント [srad.jp]で言われているような、ポリシーや方針みたいな
大雑把なものから、動作オプションの影響範囲と差、さらに細かくは
関数の引数の意味、みたいなものまで。
ドキュメントを出せ、は「俺が知りたいことが 1ページで書いてある資料をだせ」なことも
多くて、結局 google だったりする。 (私はお前のおかあさんじゃない)