タグ

pbpに関するfbisのブックマーク (2)

  • コメント!=ドキュメント : 404 Blog Not Found

    2006年09月04日15:15 カテゴリLightweight Languages書評/画評/品評 コメント!=ドキュメント なぜコメントの付け方の昔と今が違うかと言えば、原因は二つある。 Perl Best Practices Damian Conway [邦訳:Perlベストプラクティス] 小野和俊のブログ:ソースコードのコメント率は20%を切ることが望ましい 昔はソースコードのコメント率が50%を切るものはドキュメント不足で品質が低いものとされた、という内容のものがあった。 [中略] 今、改めて考えて、どのような言語であってもどのようなコーディング規約であっても、私はソースコードのコメント率は原則20%を切ることが望ましいと思う。 まずは言語仕様そのもの。昔は変数名の長さに限りが合ったり、loop controlにifとgotoしか使えなかったりで、「プログラムそのものに語らせる」

    コメント!=ドキュメント : 404 Blog Not Found
    fbis
    fbis 2006/09/04
    ある時期を境にコメントをあまり書かなくなったなぁ。それに引き換えドキュメントはいつもソースより多くなるw
  • PlaggerにTest::Perl::Criticのテストが追加されました。が - ヒルズで働く@robarioの技ログ

    いつの間にやらTest::Perl::Criticのテストが追加されていますが、コード品質のテストは開発者用テストなのでエンドユーザには必要ないのでは?と思っています。自分の場合以下のようなコードによって、明示的にmake test TEST_CRITIC=1(またはTEST_ALL=1)とした場合のみ実行されるようにしています。 t/01perlcritic.t #!/usr/bin/env perl # # $Revision$ # $Source$ # $Date$ # use strict; use warnings; use version; our $VERSION = version->new(qw$Revision: 0 $); use English qw(-no_match_vars); use FindBin qw($Bin); use Test::More; if

    PlaggerにTest::Perl::Criticのテストが追加されました。が - ヒルズで働く@robarioの技ログ
  • 1