はじめに プログラマには、ドキュメント、とくにプログラムの内部仕様書を書くのが苦手、 という人が多い。 その理由は明らかであって、そもそも、ソースコードに (バグも含めて)*1 すべての仕様が子細もらさず書かれているのに、なぜ、さらにそれと独立した仕様書が必要なのかと、 (半ば本気で) 思ってしまうからである。 ソースコードと独立にメンテナンスをしなければならないような仕様書は、 いずれソースコードと整合性が取れなくなって、無意味ならまだしも、 かえって害をなす存在となり果てることもある、ということを、 彼らは経験的に理解しているのである。 (*1) Ruby の作者である、まつもとゆきひろ氏は、 その著者『オブジェクト指向スクリプト言語 Ruby』の中の「付録C Ruby 用語集」で、 次のように書いている: ドキュメント まつもとの苦手なもの。彼は普段から「ソースがドキュメントだ。
最近の更新 2021.6.15 新規追加 福岡県朝倉郡東峰村 大行司 福岡県田川郡添田町 添田駅~西添田駅 福岡県田川郡添田町 英彦山 福岡県田川郡川崎町 豊前川崎駅周辺 福岡県田川郡大任町 今任 福岡県田川郡赤村 油須原 福岡県京都郡みやこ町 犀川 福岡県築上郡吉富町 広津 福岡県築上郡上毛町 上毛町役場周辺 福岡県嘉麻市 大隈 大分県東国東郡姫島村 姫島港周辺 大分県宇佐市 長洲 大分県宇佐市 安心院 大分県宇佐市 宇佐神宮周辺 大分県国東市 伊美 2021.5.17 新規追加 東京都足立区 宮城・小台 東京都足立区 新田 改称 「東京都北区 王子」を、「東京都北区 王子・豊島」に改称 全面更新 東京都北区 王子・豊島 過去の更新履歴 10393143Access (since 2004.2.23)
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く