Let’s use doxygen!
はじめに プログラマには、ドキュメント、とくにプログラムの内部仕様書を書くのが苦手、 という人が多い。 その理由は明らかであって、そもそも、ソースコードに (バグも含めて)*1 すべての仕様が子細もらさず書かれているのに、なぜ、さらにそれと独立した仕様書が必要なのかと、 (半ば本気で) 思ってしまうからである。 ソースコードと独立にメンテナンスをしなければならないような仕様書は、 いずれソースコードと整合性が取れなくなって、無意味ならまだしも、 かえって害をなす存在となり果てることもある、ということを、 彼らは経験的に理解しているのである。 (*1) Ruby の作者である、まつもとゆきひろ氏は、 その著者『オブジェクト指向スクリプト言語 Ruby』の中の「付録C Ruby 用語集」で、 次のように書いている: ドキュメント まつもとの苦手なもの。彼は普段から「ソースがドキュメントだ。
昨日はじめたばかりのダイアリー初心者が最初に覚えたい「5つのはてな記法」 - シナトラ千代子
自分の経験からくるものなので、あくまでサンプルということで。 最近、知り合いのはてなダイアリー初心者にいろいろと教えることがあって、まずなにを覚えたらいいか、そのあたりを簡単にまとめてみました。 「とりあえず書ければええねん、デザインとかはあとで考えたらええねん」というかたのためのものです。これがベストではありませんが、あとは少しずつ覚えていけばいいかと思います。 はてな記法ってなに？ はてなダイアリーで使用できる「省略化されたHTML」と考えてください。 いろいろあります。 →●はてなダイアリーのヘルプ - はてな記法一覧 どれから覚えるべきかを簡単に説明します。 最初に覚えるべき5つの記法 まずは以下の5つです。 見出しをつける（見出し記法） 改行タグを挿入する（改行記法） リンクを簡単に記述する（http記法、mailto記法） 引用ブロックを作る（引用記法） はてなフォトライフに登
誰も読まないOSのソース・コード：ITpro
まず，結論から言おう。 「エンジニアがOSのソース・コードを読めるようになると，活躍の場が一気に広がる」。そして，「コツさえ分かれば，OSのソース・コードはびっくりするほど簡単に読める」。 ここでいうOSとは，Linuxのカーネル（OSの“核”となるソフト）のことである。筆者が上の2点を強く感じたのは，つい最近の，ある人物とのやり取りがきっかけだった。 「カーネルのソースが読めると，たいそう儲かるってことが，分かってしもうたから」。「もうすぐ大学の仕事は定年や，でも定年後の収入の方が多いんとちゃうかな」---。 筆者の耳に，迫力ある関西弁が突き刺さった。声の主は1949年生まれの57歳。神戸情報大学院大学助教授の赤松徹氏その人である。 打ち合わせを兼ねた取材の後の会話だったので，メモは取っていない。赤松氏がはっきりとこの通りに発言したかどうかは覚えていないが，筆者の脳裏には，そのような発言
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
