個人にもチームプロジェクトにも役立つソースコードのコメントの使い方
長期に渡るプロジェクトほどコードのコメントは重要性を増すものです。複数のプロジェクトを同時進行したり、複数の人が関わるチームで開発するときなどに役立つコメントの使い方を紹介します。 Source Code Comment Styling: Tips and Best Practices [ad#ad-2] 下記は気になった箇所をピックアップして意訳したものです。 コメントのスタイル より良いコメントにする4つのテクニック コメントのスタイル 1. インラインのコメント ほとんど全てのプログラム言語でインラインのコメントが使えます。これは一つのポイントに一行のコメントのテキストを書くことに限定されます。 例を見てみましょう。 // begin variable listing var myvar = 1; .. これはその機能を説明するためのコメントで、使い方としては申し分ないでしょう。もし
くずHTMLが健在な5つの理由 - builder by ZDNet Japan
2年強前、私は開発者たちにひどいHTMLを書くのをやめて欲しいとお願いする記事を書いた。しかし、その後この問題はさらに悪化している。 何週間か前、私はTech Republicのこのブログの読者に対して、自分のHTMLの品質について聞いた。読者の約25％が自分のHTMLはすべての標準に準拠しているという主張だった。私はこのブログの読者についてよく知っているので、この数字は正しいと信じている。しかし、私はこのブログの読者がかなりの少数派であることも知っている。残念ながら、くずHTMLは健在だ。 ここに悲しいニュースがある。AlexaのTop 500のサイトのページで正しいものは7％以下だというのだ。これは、これらのページだけの問題なのだろうか。残念ながら違う。研究者によれば、「これははるかに大きなMAMAの分析対象全体よりも少しよい結果となっているが、サンプル数と差分が小さく、差があるとはっ
Concepts + Principles - プログラミングの原則 - Concepts + Principles - Top
ここはプログラミングの原則を集める Wiki です。巨人の肩に乗って、ふつうの人がよいプログラムを書くための指針を集めたいなと思ってます。 目次 よいデザインのための Concepts + Principles DRY (Don'tRepeatYourself) 名前重要 直交性 トラッシュではなくクラッシュ DuckTyping よいルーチンを書く 凝集性 結合性 契約による設計 (DesignByContract) ルーチンを作る正当な理由 よいモジュールを書く 適切なモジュール性を確保するために守らなければならない5つの原則 開放/閉鎖原則 (OpenClosedPrinciple) よいアプローチのための Concepts + Principles 曳光弾 可逆性
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
koshigoewiki:php:デザインパターン [KoshigoeWiki]
Cheat-Sheets.org
