青木日記

■ RHG

ksaito さん、みなさん、ありがとうございます。確かにあまりに後ろ向きでした。 ここでウダウダ言ってても印刷されて世の中に出回ってしまった本が直るわけでなし、 (反省は大切ですが) 今日からは前向きに対処したいと思います。

(20:18)

■ RHG / 英語

そういえばチラホラと「RHG 英訳しろ〜」って声が見えますね。 結論から言うと、出版前提では無理です。 ウェブ公開で、おもいきり縮小した版ならなんとかなるかもしれません。 (という条件でインプレスの了解はとってあるんですよ、いちおう)

(21:29)

■ でも

とりあえず、三ヶ月くらいたってから考えます。

(21:33)

■ to do リスト駆動

何から手を付ければいいのかわからないときは まず to do リストを書き出すといいようだ。 そのあと優先順位を決定し消費時間を予測して書き込む。 仕事をやり終えたらリストから消す。 だいたいの項目が消えたらリストを作りなおす。

まああたりまえの手法だと思うんですけど、 あたりまえができてないので意識しないとできないのです。

(21:46)

■ そのときの媒体

やっぱ紙じゃない。

(21:46)

■ ま、

そんなこと言いつつも、使用時間の予測なんてしてませんが！ こないだ何かの記事に「決めたほうがいいよ」って書いてあったんです。

(21:49)

■ レビュー

結城さんは無料レビューかあ。RubyBookML みたいなものかな。 こっちはわりと (いや、かなり) Ruby 界に偏ってるけど……。 今度なにか書くときは募集してみようかなあ。

(21:54)

■ todo リスト駆動

重要なことを忘れていた。

• 途中で項目を追加しない。重要なことならそれを追加してリストを作りなおす。

だめなんだよー、どうしても途中でメール見たり スラドのヘッドライン眺めたくなるんだよー。 特に嫌なことをしてるときに。

(21:56)

■ to do リスト駆動

to do リストは複数作らない。(ポケット一つ原則)

(22:02)

■ to do リスト駆動

しかしリストを分けたほうがいいこともある。 短期のリストは一つにすべきだが 長期のリストは分野ごとに別々に書いたほうがよさそうだ。

(22:24)

■ to do list driven

役に立たない to do list の例

• RHG バグ処理
• 原稿書く
• 掲示板にリプライ
• メール
• http
• cvs

(22:28)

■ to do list driven

メールボックスを to do list にするというのはどうだろう。

Outlook Express にそんな機能があったような気もする。

でもやっぱ紙がいいなあ。画面だとすぐ隱れちゃって嫌。 紙ならモニタの横に広げられる。

# 今日の日記はほとんどメモ用紙だよなー。

(22:46)

■ 間違いの少ない文章を書くには

短くまとめようと思ったのに、 いつのまにか自作ツールのマニュアルになりかけていた。危なかった。

重要度順。

• 時間的な余裕を十分にとる。

時間に追われて書くと必ずなにか失敗する。 できることならまず全部書き終えて、それから一定の期間校正する。

が、実際には無理なことも多い。特に雑誌とか。

• 徹夜しない。休みなしで書かない。

徹夜して書くと進んだような感じがするが その次の日に結局寝てしまったりしてだいたいチャラになる。 また夜ばかり活動していると非常に強い疎外感に呵まれるのでよくない。

ようするに、精神状態を良好に保つようにする。

• 自動テストできるところは例外なく全て自動テストする。

例えば埋め込んだプログラムなどは別ファイルに書き出しておき、 Ruby プログラムなら実行してみてテストする。もちろんそれを手でコピーして いるのでは意味がないので、自動インクルードする。 他に「禁止用語」なども自動チェックできる。

さらに、章をまたいだ内容の参照などは『第○章で述べたように……』などと 定型で書いておくとあとから自動検出できる。

• 文章は人がテストする。

プログラムはプログラムでテストする。文章は人が読んでテストする。 当然筆者も死ぬほど読むが、どうしても無意識の前提や先入観が邪魔をするので できるだけたくさんの人の目にさらしたほうがよい。

• レビューには完全な形の原稿を使う

レビュアには図版まで含めたものを提示する。 フォーマットは、dvi や PostScript が見られるならそれでもいいが、 レビュアにその環境がない場合を考えると HTML あたりが適当だろうか。

(23:08)