コメントからドキュメント生成 phpdocumentorとは phpdocumentorとは、スクリプトに一定の形式に準拠してコメントを書くと、コメントからマニュアル生成するプログラムです。 コメントの形式は以下のようになります。 /** * __construct 簡単な解説 * * 詳細な解説1 * 詳細な解説2 * * @access public * @return void */ コメントの最初に一行で簡単な解説を書きます。 続けて、長めのコメントを書きます。 さらに、タグ(@で始まる) を利用して、利用されている変数、戻り値等を示します。 良く利用するタグ phpdocumentor で利用頻度が高いと思われるタグをいくつか紹介します。 @access アクセス権限(private protected public) @deprecated 古い(使うべきではない) @fina

2012年05月15日 Web制作者が自分で自分の首を絞めている現実、Webサイト制作単価の下落について思うこと 最近毎日のように作業単価について考えてる。— Y0shiDaさん (@tatzuya) 5月 15, 2012 先日、@tatzuyaさんのツイートを拝見して、日頃思うところを書いてみようと思った次第。「Webサイトの制作単価を下げているのは、我々制作者自身であり、自ら首を絞めているのではないか？」ということ。あくまでも、私の「個人的な主張」である。これは冒頭で強調しておく。 Webサイトが世間一般に広く行き渡り、新規制作案件よりもリニューアル案件の方が多い昨今。つまり、「飽和状態」である中で、Webサイトの制作単価が下落するのは当然のことだと思う。それは仕方ない。 ただ、現場レベルの話へと落とし込んだときに、「Webサイトの制作単価下落」の原因は以前からそこではないような気が

Joel Spolsky ジョエル・スポルスキ 翻訳: Yasushi Aoki 青木靖 2000/10/24 私の知っている筋金入りのC++プログラマたちの多くは、ユーザインタフェースプログラミングを嫌っている。これは私にとっては驚くべきことだ 。それというのも、UIプログラミングが本質的にやさしく、直感的で、楽しいものだと知っているからだ。 それがやさしいというのは、どうやって矩形を別な矩形の真ん中に配置するか、という以上に複雑なアルゴリズムは、通常必要にならないからだ。それが直感的であるというのは、もしあなたが間違ったならたちどころにそのことがわかり、修正できるからだ。楽しいというのは、あなたの作業の結果を即座に見ることができるからだ。あなたは自分がプログラムを直接彫刻しているかのように感じるだろう。 私の考えでは、プログラマがUIプログラミングを怖れるのは、ほとんどの場合彼らのUI