nDiki : 2005年03月30日

2005年3月30日 (水)

■ わかりやすいマニュアルを作る文章・用字用語ハンドブック

今日の作業で今年度の作業に区切りがついて一段落。 (いつものことだが)マニュアルについては後手にまわってしまって完成度の高さが充分ではなかったと反省。

いや、時間だけの問題ではないな。考えてみれば、テクニカルライティングのイロハをきちんと学んでいない。自分で書くにしても他人が書いた物の問題の指摘をするにしても、これはいけない。

それから、電子マニュアル化ソリューションを提供するなんて言うのに「マニュアルとはなんぞや」を学んでいないなんて恥ずかしい。 Webベースソリューションを提供する企業のWebサイトが駄目駄目なのが恥ずかしいのと同様。

ということでまずは書籍をチェック。まずは評判の良い「わかりやすいマニュアルを作る文章・用字用語ハンドブック」を手にしてみた。主にコンピュータ業界を対象にした内容になっているが、書泉ブックタワーではコンピュータ書籍のフロアではなく1階上のフロアに置いてあった。

冒頭で

この本は、この本で示したルールに従って書いています。p.iii

と書かれている。素晴しい。 X言語で書かれたX言語処理系とか、そういった自己記述・自己適用の好きな自分のハートをがっちりキャッチされた。

まずマニュアル作成工程

企画
目次の作成
アウトラインの作成
レイアウトの決定
執筆規則の作成
執筆と推敲
査読とテスト

の概要が解説されている。この点からして頭の中で整理されていなかった部分があるので有り難い。

さすが、読みやすく書かれているのでさらりと読めそうだ。

[ 書評 ] [ お薦めの本 ]

スポンサードリンク

[ permalink ]

すごい会議 - 短期間で会社が劇的に変わる! (2005-05-27)
Life Hacks PRESS で Life Hacks をおさらい (2006-03-28)
Joel on Software - 必読書 (2008-08-14)
トム・デマルコゆとりの法則 - 誰も書かなかったプロジェクト管理の誤解 (2004-04-17)
ソフトウエア開発 55の真実と10のウソ読了 (2004-06-08)

■ X-Deep/32 Xサーバ

Windows で Xサーバを使いたくなる衝動が時々やってくる。今回は Linux 上の Firefox を Windows 側に表示させたいというのが希望。

Xサーバについては以前 Cygwin/X を試したりしたしてみたが、今は Cygwin 自体をアンインストールしてしまっている。今回は別のものを試してみることに。

@ Xming

MinGW を使っている。設定は Cygwin/X とほぼ同じらしい。 Xサーバ以外は特に何もはいっていないし、これなら Cygwin/X を使った方が便利そう。

@ X-Deep/32 4.6.5

マルチウィンドウモード+ルートウィンドウ無しでXサーバを起動し、Linux BOX を許可するホストに追加。 Linux BOX 側から DISPLAY 環境変数か --display オプションを設定して Firefox を起動。これで Windows 側に Firefox のウィンドウが表示される。

日本語は今のところ入力不可。表示はできる。

しかし1つのFirefoxから2つのDISPLAYに同時にウィンドウを出せないのか(別プロセスになってしまい、同じプロファイルを同時に使えない)。これでは今回の目的は達成できず。

ちなみに X-Deep/32 はXクライアントのランチャもついているのだが、rsh か rexec による起動になる。ちょっと使えない。

[ permalink ]