たしかにに関するvixyのブックマーク (2)

  • 小野和俊のブログ:ソースコードのコメント率は20%を切ることが望ましい

    大学の研究室の教官は昔NTT研究所の所長をされていた苗村先生という人で(と言いつつ私は大学の研究室にほとんど顔を出していなかったのだけれど)、彼の発言のうち印象に残っているものの一つとして、昔はソースコードのコメント率が50%を切るものはドキュメント不足で品質が低いものとされた、という内容のものがあった。 今、改めて考えて、どのような言語であってもどのようなコーディング規約であっても、私はソースコードのコメント率は原則20%を切ることが望ましいと思う。可読性の意味でもメンテナビリティの意味でも、開発生産性の意味でも。私が考えるに、来コンピュータが読むためのものであるソースコードに人が読むためのコメントを付け加えなければならないのは、次の2通りの場合だけである。 1.公開されるAPI APIやソースコードそのものが公開される場合、利用者は不特定多数となり、利用者のスキルにもばらつきが出て、

    小野和俊のブログ:ソースコードのコメント率は20%を切ることが望ましい
  • 404 Blog Not Found:サルでも生産性が上がるオープンソース

    2006年09月02日22:15 カテゴリOpen Source サルでも生産性が上がるオープンソース というわけで、続き。 404 Blog Not Found:1998年じゃ遅すぎる 次のentryからそのあたりを考察していくことにしよう。 主題は、こちら。 「Googleはオープンソース組織を内部に持つ営利企業」---梅田望夫氏が語るシリコンバレー精神とオープンソース:ITpro 謎のひとつは「スケジュールもなければロードマップもない。てんでばらばらなのに,非常にクオリティの高いソフトウエアが生まれてくる」(吉岡氏)という,オープンソース開発モデルの生産性の高さだ。 なぜ、オープンソースの生産性は高いのか? 身も蓋もない答えを言ってしまおう。 生産性が充分高いプロジェクトしか手をつけられないからだ。 「生産性が充分高い」とはどういうことか、というと、「すでに他でうまく行っているプロジ

    404 Blog Not Found:サルでも生産性が上がるオープンソース
  • 1