コメント!=ドキュメント : 404 Blog Not Found
2006年09月04日15:15 カテゴリLightweight Languages書評/画評/品評 コメント!=ドキュメント なぜコメントの付け方の昔と今が違うかと言えば、原因は二つある。 Perl Best Practices Damian Conway [邦訳:Perlベストプラクティス] 小野和俊のブログ:ソースコードのコメント率は20%を切ることが望ましい 昔はソースコードのコメント率が50%を切るものはドキュメント不足で品質が低いものとされた、という内容のものがあった。 [中略] 今、改めて考えて、どのような言語であってもどのようなコーディング規約であっても、私はソースコードのコメント率は原則20%を切ることが望ましいと思う。 まずは言語仕様そのもの。昔は変数名の長さに限りが合ったり、loop controlにifとgotoしか使えなかったりで、「プログラムそのものに語らせる」
ProgrammerProverb - MoriMoin
プログラマ格言 PHPを笑うものはPHPに泣く 意味: 「PHPなんてまともなプログラミング言語じゃないよ」と笑っていたら仕事でPHPを触るはめになってしかも既存のソースが汚かったりして泣く。 教訓: 好き嫌いを通せるようにえらくなれ。 ソースが知れる 意味: 変な挙動をするソフトをさわっていると、動き方から間違ってるパターンと作った人のレベルがなんとなく透けて見える。 教訓: どうやったらうまく動くか探すのも仕事のうちらしい。 ひいきのwiki倒し 意味: 「wikiはすばらしいツールですよ！」 と、とにかくwikiを導入してメンテ不良のページを大量につくってしまう。 教訓: 情報共有ツールは使う人のメンテナンス能力が一番のネック。 ライブラリからボタ餅 意味: 延々ぐぐってみつからなかった情報がライブラリのソースであっさりみつかった。 教訓: ライブラリのソースは
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
http://nayuki.iza.ne.jp/blog/entry/2647/
