[マニュアル作成] カテゴリの記事

全111件 (111件中 1-50件目)

1 2 3 >

• 

  １３番が見つからない（滝田）

  こんにちは。テクニカルライター＆WEBライターの滝田です。上司の蝦名と札幌駅の地下歩道を歩いていたときのことです。私たちは、１３番の出口を探していました。「１３番出口、どこかな」「右方向のようです」「あったあった、あっちだね」「まっすぐですね」「ここをずーっと直進だよね」「そうですね」「おやっ、１３がなくなった？」「あれ、どこでしょう？？」案内に近づいてみるものの…「１３、ないですね？？」しばしうろうろと探したものの・・・よくよく見てみると・・・ありました。ぐるりと回り込んで、やっと発見。案内に従って直進してきたときは、こう見えていました。↓↓「これじゃ、わかりにくい（笑）一度、歩いて確かめてみれば、わかるのにね」「そうですね、マニュアル制作の基本ですよね」こうして多少時間はかかったものの、私たちは無事に１３番出口にたどり着けたのでした。===========ソフトウェアのマニュアルを作成するときは、すべてを執筆した後、マニュアルの原稿を読みながら、ソフトウェアを操作してみます。一度冷静になって、原稿を読みながら操作してみると、夢中で書いていたときには気がつかなかった矛盾点や情報の漏れなどが見つかるものです。マニュアル制作だけに限った話ではないと思いますが、完成したと思ったら、一呼吸おいて、まっさらな気持ちになって振り返ってみる。これが大切ですね

  2010/01/15

• 

  「作って終わり」ではありません（滝田）

  こんにちは。テクニカルライター＆WEBライターの滝田です。CMS（コンテンツマネジメントシステム）を駆使してホームページを構築できる制作会社は数あれど、「お客さまに応じたホームページの更新手順書も作れるよ」という制作会社は、どれくらい存在しているものでしょうか？もちろん、私たちの強みのひとつは、そこです。CMSを使ったホームページを構築する場合は、お客さまのご要望やホームページの目的に応じてカスタマイズすることが常。ですから、汎用版の更新手順書だけお渡ししても、結局、よくわからない、、、ということになってしまいます。ご自身で更新できるよう選択したはずのCMSなのに、更新方法がわからなければ、本末転倒でしょう。そこで、テクニカルライターの出番です。私たちは、お客さま専用の「ホームページ更新手順書」を作成しています。ちなみにこの更新手順書、ホームページ公開後に開催する、更新手順 勉強会のテキストになります。ホームページは、更新していかなければ意味がないというのが私たちの方針。ですから、家に着くまでが遠足、ならぬ、更新できるようになるまでがホームページ制作という気持ちで、フォローさせていただきますっ▼▼　おまけ　▼▼さてさて、CMSのひとつである、MovableType。その新バージョン「MovableType5」が、出荷開始となったようです。社内で回覧されたMovableType5のパンフレットをひとめ見て、私はある重大な変化に気がつきました。●MovableType4●MovableType5そうです。スパナのイラストの向きが、変わっていたのです。販売元のSixApartの方が、この記事を読んだに違いないhttp://plaza.rakuten.co.jp/technicalwriter/diary/200812050000/と、ひそかに確信している滝田です

  2009/11/27

• マニュアル制作は職人仕事（滝田）

  こんにちは。テクニカルライター＆WEBライターの滝田です。他の会社の方に自己紹介をすると、驚かれることがあります。「マニュアルを作っている人が、いるんだ。」そうなのです。いるのです。あなたの持っている携帯電話についていたマニュアルも、どこかのテクニカルライターが、せっせと執筆したのですよー。「メーカーの人が、自分たちで作っているんだと思った。」はい、そういう場合もあります。でも、社内にマニュアル制作部門があるメーカーさんは、今の時代、だいぶ少なくなっているのではないでしょうか。たとえ、専門のマニュアル制作部門がなくたって、どんなクオリティでもよければ、社内で適当に済ましてしまうこともできるといえば、できます。適当に作ったマニュアルというのは、ちっとも役に立たないものですが･･･。マニュアル制作は、執筆以前の準備の段階が最も重要なのです。だからこそ、マニュアル制作を私たちに依頼してくださるお客さまというのは、マニュアルをある程度「無視できないもの」とみなしてくださっていると、勝手に理解しています。ユーザーの利益を第一に考えた、なんてすばらしい企業なのでしょうと、尊敬の念を持ってしまいます。マニュアル制作会社の私たちが、そんなお客さまのためにできること。それは、本当に役に立つマニュアルを作ること。つまり「見やすく」「探しやすく」「使いやすい」マニュアルを作ることです。そして、心がけていることとしては、作成するマニュアルの先に、それを手にするエンドユーザーを意識すること。こうした姿勢で制作にあたると、お客さまからの指示にはないけれど、ここも修正したほうがよいのでは？などという箇所に気がつくようになるものです。「こんな場所を見つけたのですが、対応してもよろしいでしょうか？」こんな風に質問することで、お客さまにかかる、マニュアル制作の負担をできるかぎり減らしたいとも、思っています。

  2009/11/20

• ゲームの取扱説明書　おもしろさ、新発見！（滝田）

  こんにちは。テクニカルライター＆WEBライターの滝田です。それは、突然のお問い合わせでした。遠く離れた関東圏のお客さまから、ゲームのマニュアル制作をご依頼いただいたのです。インターネットで見つけてくださったのでしょうか？ご縁とは、とても不思議です。ありがとうございます。対象製品がゲームの場合、取扱説明書は1冊の中で、ざっくりと次の２つに分類できます。（１）ストーリーやキャラクター紹介など、ゲームの世界観を表す部分（２）ゲームの操作説明の部分そして、ゲームの取扱説明書でより大切にするのは、前者の世界観。ゲーム好きの方なら、操作説明は見なくてもわかる！という方も多いことでしょう。ですが、ストーリーは「読まなくてもわかる」というわけにはいきません。言ってみれば、ゲームの肝。必ず読まれる部分だからこそ、ゲーム本編にスムーズに入っていただけるよう、配慮しています。※もちろんテクニカルライターとしては、操作説明の部分が読まれないと、それはそれで悲しいのですが、、、今回、ストーリーやキャラクターの設定などは、あらかじめ仮原稿をご用意いただけました。そのうえで、読みやすくしていくことが私たちのミッション。ですが、読みやすさを重視するあまり、業務用アプリケーションの取扱説明書のように、すべての解説をたんたんを綴ってしまっては、ストーリーの面白さが損なわれてしまう。このさじ加減が難しいところです。そして、ストーリーの世界観を正しく理解できているかが不安だったため、お客さまに電話で取材させていただきました。製作者の方のお話を伺って、原稿の細部を修正すると、目の前の原稿に、命が吹き込まれるような気がするから不思議です。マニュアル完成まで、もうしばらくですが、良いものをご提供できるようがんばります。余談ですが…操作説明の部分を執筆するために、実際にゲームで遊んでみました(^^)白熱すると、ついつい体が動いてしまう私でありました。))))

  2009/10/30

• 

  久しぶりのInDesign （白藤）

  みなさま、お久しぶりです。休日出勤が多い私ですが、4月29日から5月6日までフルに休んで、北京で遊んでみました。日本の常識は通用せず、かつ広大な中国で、人間が適当に、 大きくなったような気がしています。さて、7日からは通常の勤務に戻ったわけですが、ひさびさにInDesignを使って、マニュアルを書いています。市場の伸びから言って、マニュアルよりも、ホームページの案件が多くなっていること、ホームページ制作のディレクターが不足していることもあり、なかなか、マニュアルの現場を担当するのは難しい今日この頃。今回は、マニュアルプロジェクトに人を配置できないので、私がユーザーズマニュアルを書いてます。マニュアル書きのおもしろさは、一種独特のリズムがあること。マニュアルを書き始める前に作った用語集（グロッサリー）をながめつつ、そのとおりに用語が統一されているかチェックするのもそのひとつ。用語が統一されていないと、読む人がわからなくなるので、性格が悪くなりそうですが、細かいところまでチェックが必要です。そこまで気がつかないよ。そうかもしれませんが、、、統一されていない用語に「あれっ」て思う、野性のカンは持ち続けていたいです。

  2009/05/11

• テクニカルライティングは職人しごと（滝田）

  テクニカルライター＆WEBライターの滝田です。久々に、行ってきました。札幌交響楽団の定期公演で、札幌で唯一のコンサートホールKitara（キタラ）へ。驚いたのは、演奏終了後。さっきまでステージ上で演奏していたはずの団員さんが、すでに私服で楽器を背負い、私達の前を歩いている。。。は、はやっ「反省会とか打ち上げなんて、しないのかなぁ」などと、素人は思ってしまうのですが、そこはやはり、オーケストラというプロの集まり。1人1人が「音楽家」という職人なので、演奏終了 ＝ 仕事終了 → 撤収　が常識だとか。へええ(ﾟДﾟ)おまけに、演奏会 ＝ 仕事場 、つまり現場という発想から、「次の現場、どこ？」という会話が飛び交っているらしいです。へえええ (ﾟДﾟ)----------------------------------------------私は、ライターの仕事も「職人仕事」だと思っています。そして、どちらかといえばWEBライターよりもテクニカルライターのほうが「職人仕事」に近いですね。マニュアルを書く場合、WEBライティングのように「思いや人柄」を表現する必要はありません。求められるのは、取扱情報を分析・分類するテクニックと、アプリケーションを使いこなす知識、そしてどんなにハードなスケジュールでも決してあきらめず、満足できる質の制作物を納品するド根性。。。本日、会社のパソコンにDTPソフトをインストールしながら、そんなことを考えていました。さあ、今年も新たなマニュアル制作が、始まる～！燃える～！

  2009/02/13

• プロとアマチュアの違いはどこに （白藤）

  ■操作マニュアルを書くのは簡単だエッセイ、小説、詩などと違い、操作マニュアルは誰でも書けそうな分野ですね。「事実」を書くライターには、新聞記者・雑誌記者さんもいます。現場に出かけて取材したり、特定の人をインタビューして記事を書きおこすよりも、操作マニュアルはもっと簡単に書けそうです。目の前にある、ソフトウェアを淡々と操作して、そのとおりに書けばよいのですから。はい。そうなのです。必要な操作を、時間の順番に書いていけば、操作マニュアルになります。■じゃあ、マニュアルを外注する意味ってあるの?テクニカルライターは、その誰でも書けそうな操作マニュアルを仕事として請け負っています。テクニカルライターにマニュアルを書いてもらう意味がわからない。そう思われるかもしれませんが、、、テクニカルライターは、　(1)読者に、どうしたら操作手順をわかってもらえるか　(2)どの順番に機能を並べたら、理解しやすくなるか　(3)開発中で、原稿の締め切り直前でないとソフトが使えないのに　　 どうやってマニュアルを書くかなどなど、マニュアルのことを専門に考えているので、そこに存在価値があると思うのです。(1) たとえば、、、　　注意するのもタイミングが必要なのですこの間、リライトを依頼されたマニュアルは、1. 新バージョンのインストール2. 旧バージョンの削除という順番に書かれていました。そのとおりに操作してみたら、2.旧バージョンの削除の途中で、この操作は新バージョンのインストール前に行ってください。と書いてありました。この場合は、旧バージョンを削除しないと、新バージョンをインストールできないのであれば、旧バージョンの削除を先に書く必要がありますね。ただ、新バージョンから買った読者には、旧バージョンは関係ありませんから、旧バージョンについては、読む必要はないという案内も必要です。テクニカルライターは、マニュアルのことに専念しているので、操作の条件、読者の条件など、分析してから原稿を書きます。～～～～～～～～～～～～～～～(2)よく使う機能、たまにしか使わない機能、１回しか使わない機能　 何を先に書いたらいいかなよく使う機能は、そのうち操作を覚えるから中でもいいか、たまにしか使わないけど重要だったら、探しやすいほうがいいかな、１回しか使わないなら、どうしよう。目次を作るときに、試行錯誤します。正解はありません。製品の特徴や、最初に設定しないと動かないなどの動作条件、探しやすさなど、条件はさまざま。目次作りには時間がかかります。～～～～～～～～～～～～～～～～～～～～(3) 要求定義書、外部仕様書、製品企画書、　　メールでの質問、インタビュー、ありとあらゆる手段を使います開発中の製品で、不具合がまだたくさんある場合でも、操作できるほうが、できないよりいいです。そういうバージョンから使わせていただきます。ですが、それすらできない場合は、ソフトウェアに関連する資料をできるだけ入手して、画面と画面のつながりをまとめて、操作手順を推測します。その上で、設計者に確認。操作手順だけではなく、できる限りその結果も解明してマニュアルを書いていきます。ときには、決まっていない仕様を、マニュアル側で決めてしまうことも。(^^ゞWebアプリケーションの場合は、操作がある程度パターン化されているので、Windowsなどのアプリケーションよりは、操作方法を推測しやすいです。■淡々と300ページのマニュアルを書けるか機能別に解説する、リファレンスマニュアルの場合、同じ流れで、淡々と操作手順を書いていく必要があります。決められた用語を使い、解釈がひとつになるように文章を書いていく。300ページを１か月で書くとなれば、たぶんライターは複数になる。誰がどこを書いたのか、その個性がでないように、統一の基準、表記で書いていきます。そういうことができるのも、やっぱり、マニュアルを専門に書くライターだからだと思うのです。～～～～～～～～～～～～～～～～～～～～もう完成しているソフトウェアの操作手順なら、誰でも書けるかもしれない。でも、目次の作り方、情報の配置の仕方、納期との兼ね合い、そういうさまざまな条件でも書ける。それがプロの仕事だと思います。

  2009/01/12

• 只今 こつこつ 没頭中 （滝田）

  現在、私が担当している仕事は、もともとWindows Helpだったものを、HTMLヘルプとして完成させること。Windows Vistaには、WinHelp（Windows Help）の動作に必要なプログラム（WinHelp32.exe）が搭載されないので、これまで使っていたヘルプがVistaでは表示されない・・・といったことが発生するのですね。さて。このヘルプ制作がどのように進むかと言いますと…●WinHELP解体!まずは、RoboHelpでWinHelpを逆コンパイル。すると、バラバラのHTMLファイルに変換されます。その数、200以上！●逆コンパイル後は･･･バラバラになったHTMLファイルには、不要なタグが入ったりするので、こつこつとひとつずつ、レイアウトを整えていきます。ノリだすと、時が経つのを忘れて没頭・・・●レイアウトを整えたあとは･･･製品の仕様変更に併せて、文章の修正、図版の差し替えと作業は進みます。こうなると･･･完成間近！ROBOHelp再登場ROBOHelpで、ヘルプ特有の「目次」や「キーワード」などを設定してから、最後にもう一度コンパイルすれば、できあがります。現在、第２段階のレイアウト修正中なのですが。会社の机、向かって左にWindowsXP。右にはVistaと、2台のパソコンを見比べながら、明日もこつこつ～♪♪

  2008/12/09

• 

  スケジュール表をみて、しばし過去を思い出す（白藤）

  とある日の朝、出社すると机の上にハートマーク付きのスケジュール表が置いてあった。私の仕事内容が変わったので、マニュアルプロジェクトでは、メインで動くことは少なくなったのですが、、、お客様から届いた、マニュアルの指示書を確認して青くなった私　。のうきが、、、これではまにあわない、、、ぴちぴちフレッシュライター タッキーは、まだ、版型変更の恐怖を味わったことがなく、根性でなんとかしようとしていた。「タッキーができないんじゃなくて、　時間がなくてできないんだよ。」そう彼女を説得し、強制的に、ライター全員を出動させることに決めた。そうして、進行管理と渉外窓口担当のタッキーは、制作ごとの進行スケジュールを作り、全員に配布してくれたのでした。================さて、４種類の制作物のスケジュールをみて思い出したのは、、、時間との闘いだった、保育園時代の日々。マニュアルの佳境のときは、延長保育のお迎えぎりぎり、７時に保育園に飛び込む毎日。なんだか、時限爆弾を抱えて仕事をしていたような気分でした。のんびりした保育園で、また延長保育の子も少なかったので、若い保母さんとうちの子と二人、アイスを食べていて、結局、保育園を出たのは30分後ということもありました。延長保育の終了時には、園の外で子どもと保母さんが待っているなどという、厳しい保育園もある中、恵まれていたのですねぇ。その時代に思ったことは、子育てしながら働くと、仕事の采配もうまくなるということ。突発的なお休みに備えて、日々自分の仕事を第三者にわかるようにしておき、何時までに会社を絶対にでなければならないから、何時までにこれを仕上げると、逆算してスケジュールをたて、だいたい、自分でこなせる仕事を量を瞬時に判断できるようになる。もちろん、会社の人たちの理解や協力もあって、仕事は成り立っていたのですが、子どもが小さな時代に、いろんな工夫をすることを覚えました。同じ働くお母さん同士ネットワークを作って、お互いの家で、子どもたちがご飯を食べているってことも何度もありました。こういう経験の中で、子どもたちも助け合うということを覚えてくれたようです。================そんななつかしい日々を思い返しながら、今日書いた原稿のページ数を、スケジュール表に書き込んだのでした。こういうことするのも、久し振り。初校提出まで、あと４日 がんばれ!! わたし。

  2008/12/08

• 

  ここにトリセツ（滝田）

  自宅マンションのエントランスにあった、自動販売機。よ～く見ると、こんなところにも、取扱説明が。ケータイで飲みものを買う方法が、中央のディスプレイに表示されるようです。製品自体に組み込まれているため、「組み込み式」と呼ばれるマニュアルの形態ですね。このボタンを操作して、買い方の説明を読めるようです。やってみました↓↓↓支払い方法に応じた説明を選び、あらかじめ、必要な準備や手続きなどを確認。ようやく自動販売機での操作に入りました。お金を払う前に、好みのドリンクのボタンを押すんだそうです。その後、ケータイを受信機にかざして、代金を支払う。イラストもあるので、分かりやすいですね。最後の画面で、一連の操作手順の概要がまとめられていました。これ、最初にあってもいいかも?? 操作に慣れた人は、この画面だけを確認のために一読すればよいから。･･･と、深夜に自動販売機を操作しまくりました。なんらかの「新しい使い方」が世に出るときには、このように、必ず説明が必要になるはず。なにかと経費削減の対象とされやすいマニュアルですが、取扱説明そのものがなくなることはないでしょう。「分かりやすさ」「使いやすさ」を追求するマニュアル書きの生きる道は、なくなりません。

  2008/12/02

• 

  ほんのひと手間でプロの味～♪（滝田）

  手順と結果、画面例とリレーのように続いた「テクニカルライターの部屋」。今回は、画面例にプラスアルファのお話です。マニュアルは、じっくり読まなくても分かることが、一番。そのために、時には文章だけでなく、図、画像、表などを駆使して解説します。たとえばこんなかんじ。･･･これだと赤い線が、画像の黒い部分と同化して見えてしまうかも。。。う～ん、駄目ではないけれど、もうひと声！そんなときに我々が取る方法が、こちら。ポイントは、赤い線よりも1.5倍程度太い線で作成することですね。赤い線の後ろに配置すれば、こうなります。↓いかがでしょう？白いふちがない時よりも、見やすくなったのではないでしょうか？使用前・使用後を見比べてみると…一目瞭然ですねマニュアルを見やすくするための裏ワザでした。

  2008/11/28

• マニュアル制作では画面例も大切デス（下田）

  ソフトウェアのマニュアルには、操作手順に添った画面の図がつきものです。11/25に滝田が、手順と結果を１対1対応にすることを書いていますが、その、結果の状態を示すのに使います。何気なく添えられているように、見えるかもしれませんが、これがなかなか、気をつけなければなりません。データの入力方法や、編集方法を解説する場面では、操作の前後の違いが、わかりやすい例でなければなりません。当然ですが、操作の前後の図のつながりが正しくなければなりません。さらに、そのソフトウェアのユーザーにとって、自然な例が望ましい。例えば、企業で使用される会計ソフトのマニュアルで、「大根１本　150円」など、家計簿のような例は相応しくありません。「それらしい」例を考え出して、思わぬ時間をとられことも、しばしば。マニュアルを企画するときのユーザー分析と情報収集が、欠かせません。

  2008/11/27

• 解体！マニュアルのキホン（滝田）

  操作マニュアルで必ず見かけるのが、こんな文章ではありませんか？１.［開始］ボタンをダブルクリックします。 　 スタート画面が表示されます。　　　　　※文章自体は、創作です(^^;)なんてことはない一文ですが、ここには操作マニュアルに欠かせない要素が詰まっています。それが、手順と結果の書き方です。テクニカルライター１年生が習うのが、このルール。手順と結果は、１対１対応にしましょう。基本的には、ユーザー自身が行うことを「手順」として書き、それを行った結果、製品がどう変化するかを「結果」として書きます。たとえばソフトウェアのマニュアルの場合、何かのボタンをクリックしたとき、実際に見えている画面とマニュアル上の画面が異なっていると、「操作が間違っていたのかも…」とユーザーが不安になってしまうからです。そんな心配を回避するためにも、操作手順と結果を１対１対応にしておくと分かりやすくなります。そして、操作手順を書く上で、もうひとつ大事な原則は、これ。手順は能動態、結果は受動態で書きましょう。このようにも言い換えられますね ↓↓・ユーザーが行う操作を能動態で書く。・ユーザーが行った操作に対して生じた結果を、受動態で書く。と、マニュアル制作者にとってはひじょーに基本的なことを書きましたが･･･実は、マニュアルの文章を書く上で何よりも大事なことは、文章のトーンを統一させることではないかなと私は思っています。マニュアルの文章とは、必要な情報をピックアップしてもらうもの。だから、読ませてはいけない。ぱっと見て、理解できるのが一番です。だからこそ、ねじれのない、統一された文体で、一定のルールに則って書くことが大切なんだろうと思います。

  2008/11/25

• 

  食べ物の恨みは怖いぜよ（滝田）

  お昼休み、ごはんのお供にちいさなカップに入ったうどんを買ったのですよ。おなかが空いていたので、作り方の説明にさっと目を通し、カップに麺とかやくをあけて、お湯を注いだのですが・・・器のふちに、カップ焼きそばの容器のような湯切り用のツメがついているのを発見。いやな予感とともに、説明書きをもういちどよく読むと...　↓↓↓※すみません、写真がちいさいですね・・・---------------------------------------------------------◎調理方法◎「めん」、「かやく入りスープ」をカップにあけ、熱湯を内側の線まで注ぎ、よくかき混ぜます。1分後にでき上がりです。より熱く召し上がるには、フタの両端５箇所のつめを開けて、「めん」だけをカップにあけ、熱湯を注ぎ、軽くほぐしてお湯を捨てます。（ふたは手でしっかりと抑えてください）あとは、調理方法１、２に従ってください。---------------------------------------------------------そう、私が目を通したのは、１と２のところだけ・・・より熱く召し上がる方法は、調理方法の前に書いてよねー(ToT)取り扱い説明では、必要な情報を必要とされる順番に順序だてて書くことが基本です。本日の教訓。

  2008/11/21

• 

  ホームページ更新マニュアルの主張【番外編】

  さて、連続して書いてきた「ホームページ更新マニュアルの主張」ですが、今回は、ちょっと恥ずかしいウラ話。--------------------------------------------------------マニュアル制作途中、たまに目を疑うような出来事が起こることもあります。たとえば、こんなこと。ホームページ更新マニュアルを作成していた私。せっせとスクリーンショットを撮っていたんです。せっせと撮って、名前を付けて、保存せっせと撮って、名前を付けて、保存せっせと撮って、名前を付けて、保存ひたすら繰り返しの作業中、まぶたが重～くなりそうなのをこらえながら、最後までキャプチャ終了。さー、次は、画像編集ソフトで必要な箇所だけ切り出して、原稿に配置していくのだっ　さくさくやるぞー！と、はりきって画像を保存していたフォルダを見てみると…えっ午後一番の作業だったためか、一瞬、意識を失っていたのかもしれません。それにしても、いったい何を考えていたのでしょうか自分に問いたい…orz---------------------------------------------------------------------------◎ メディアリュウムからのお知らせ ◎通常は、少人数6人制+全4回の『経営者のためのWeb活用塾』が、単発のスペシャルセミナーになって登場いたします！ショップ経営者から学ぶ、オンラインショップ成功の秘訣とは！？=============================================================■日　時 2008年１１月２９日（土）　14：00～17：00■参加費 3,000円（税込み）■定　員 50名■対　象 オンラインショップご担当者様　　　　　　オンラインショップにご興味のある方■場　所 正文舎印刷株式会社　多目的ホール（札幌市白石区菊水２条１丁目4-27）地下鉄東西線 菊水駅 ２番出口から徒歩５分※駐車場はございませんので、公共交通機関をご利用ください。■セミナー後に懇親会（有料）を予定しております。■お申し込みフォームこちらからどうぞ=============================================================みなさまのご参加を、お待ちしております(*^^*)

  2008/11/04

• マニュアル書きに必要なもの （白藤）

  メディアリュウムでは、各種製品マニュアル/ヘルプを執筆しております。制作したおもな製品をご紹介しますと、、、●家庭用ソフトウェア　年賀状作成ソフト　家計簿ソフト　お料理レシピ検索ソフト●業務用ソフトウェア　乳牛用飼料計算ソフト　特許検索システム　図書データ検索システム　自治体用各種ソフトウェア　新聞記事編集システム　看護師勤務表作成ソフト　コールセンター用システム　字幕システム　ラベル印刷ソフト　グループウェア●ハードウェア　ISDNモデム　ブロードバンドルータ　ネットワーク関連製品　赤外線ネットワークカメラなどがあります。マニュアル制作のご発注をいただいたあと、最初にすることは、当然ですが、対象となる製品を理解すること。そのために、お客様から製品に関する資料の提供をお願いしています。テクニカルライターとして、私が１番あったらいいなと思う資料は、外部仕様書　です。機能の概要が書かれていて、ユーザーインタフェイスがわかる資料がありますと、涙が出るほどうれしいのです。その次は、画面遷移図。仕様書のような細かい規定が書かれていないとしても、ボタンをクリックすると、どの画面に切り替わるのかその流れがわかる資料がほしいのです。それがあれば、画面から時系列に沿って、操作方法を書き出すことができます。そして、製品のプロトタイプ。ご発注時には、プロトタイプができていない場合が多いのですが、執筆中のタイミングのよい時期に、本物に近いものをご提供いただけると助かります。実際の製品で操作すると、製品の理解度が深まります。また、執筆したマニュアルが正しいかどうか、検証を行うことができます。監視カメラのマニュアルを書いたときは、プロトタイプを社内に設置して、24時間動かしていました。一定の時間ごとに、社内を撮影した写真がメールで送られてきて面白かったですよ。弊社内で使用できないシステムの場合は、お客様の会社などに出向き、操作させていただいております。そのほか、製品を理解するために、自分たちで行うことは、類似製品の調査です。入手できる場合は、そのマニュアルも入手します。用語がわからない場合は、用語集を作り、担当のライター同士で勉強会をします。それでも、わからない場合は、技術者の方に製品説明会を開いていただいたこともありました。製品の内部、しくみなどは全部理解できなくても、搭載されている機能とその目的、操作方法は全部理解する。それが、テクニカルライターとして、必ずするべきことだと思うのです。マニュアルを納品させていただいたあと、担当の方より、製品の使い方に詳しくなっていたときは、心の中で「やったー」と叫んでいるのでした。

  2008/11/03

• ホームページ更新マニュアルの主張【2】 （滝田）

  みなさんは、マニュアルを手にしたとき、一番初めに何をしますか？まずはパラパラっとめくってみますか？一目見て嫌気がさし、とりあえずマニュアルを机に伏せますか？（笑）私の場合は、目次を見ます。そうして、自分の欲しい情報が、どこに記載されているかを確認します。やみくもにページをめくって探すよりも、効率がいいからです。だからこそ、章のタイトルは、重要。必要な箇所を探している時間って、いらいらするものですからね...さて、次の２つのタイトルは、どちらも同じ作業を表しています。MovableTypeのホームページ更新マニュアルとしては、どちらがふさわしいでしょうか？A：投稿済みのブログ記事を編集するB：すでに公開されているページを修正する私が思うに、Bです。Aのタイトルは、このホームページが「MovableType」で作られていることを意識しすぎかな？と思うのです。「MovableType」とは、ブログ型のホームページを作るためのツールなので、ブログの記事を編集して保存するだけで、ホームページが更新できる。そこは、一般のブログと同じです。ただしユーザーにとっては、ツール目線で付けられたタイトルを見ても、ぴんと来ないかもしれません。ツール独自の概念にちなんだタイトルよりも、「したいこと」が分かるタイトル。気をつけていることの、ひとつです。# 反対に、MovableTypeの概念に慣れて欲しい場合は、# マニュアル内でそういった用語を使うこともあるかもしれません。# その際の大原則は「あらかじめ言葉の意味を定義づけること」ですね！次回につづくヾ(´ー｀)ﾉ

  2008/10/31

• ホームページ更新マニュアルの主張 【1】 （滝田）

  「MovableType※」で構築しているホームページが完成間近になると、メディアリュウム社内では、テクニカルライターの動きが慌しくなります。※MovableTypeとは、ウェブログサイトを生成・管理するサーバソフト。何をしているかと言いますと…お客さま専用の「ホームページ更新マニュアル」を作っています。●ホームページの数だけ、「やりたいこと」がある一言に「MovableTypeで作った」とはいっても、メディアリュウムでホームページを制作する場合は、お客さまの目的に合わせ、いつもたっぷりとカスタマイズしています。そのため、独自の更新手順をまとめたマニュアルが必要になるのです。※「汎用版」のマニュアルもお渡ししています。●「作って終わり」にしたくない。だから、マニュアルの出番せっかくブログ型のホームページを作ったのですから、自力で更新できなければ、意味がありません。ここで、マニュアル制作担当者にひとつの使命が課せられます。お客さまがホームページ更新用のマニュアルを目にした時に、「さー、やるぞー！」と、やる気になってもらえれば、成功「げっ、面倒…」と感じたら、失敗その後のホームページ運営につながる、大事な場面だと思っています。さて、そのための工夫とは……●会えない分だけ、愛、込めてます社内でマニュアルを作っている私は、お客様と直接お会いする機会は少ないのが現状。それが北海道外のお客様であれば、なおさらです。けれどこのマニュアルは、納品後に担当者がお客さまの元で行う「講習会」の教材となるので、確実にお客さまの手に渡り、目に入るもの。そう思うと、背筋がぴんと伸びます。このマニュアルに想いを託すぜっとばかりに、1冊1冊に一球入魂！※愛を込めすぎて少々ボリュームが増え、かさばってしまうこともありますが…(^^ゞ 普段はホームページのおまけ的な存在のマニュアルですが、これから数回にわたり、自己主張してみます「ホームページ更新マニュアル」の制作ポイントとウラ話などをご紹介していきますね。

  2008/10/28

• いい名前をつけてね（下田）

  イベントのマスコットとか、動物の赤ちゃんの名前募集ではありません。ソフトウェアのUI（ユーザーインターフェイス）の話です。コンピュータの画面には、アイコンがいっぱいです。うまくデザインされたボタンやアイコンは、目的の機能を直感的に探せ、おもしろさ・格好よさを演出でき、、限られたスペースに機能を集約できる優れモノです。でも、万人が直感的に、アイコンの意味を感じ取ってくれるとは限りません。そのため、アイコンの名前を文字で添えるとか、アイコンにマウスポインタを重ねると文字が出てくるようにしておくのは、大事なことです。また、名前がないと意外と困ってしまうのが、質問をするとき。「○○○の画面にある、×××ボタンをクリックしたけれど　うまくできません。どうしたらよいですか？」という場合、○○○や×××に名前を入れられれば簡単に質問できます。でも、名前がなければ、その画面をどうやって表示させたか、とかボタンは画面のどのあたりにあって、どんな色と形で・・・などいろいろ説明を加えていかなければなりません。これは、質問の回答をするときも同様で、名前があれば、「これ！」と明確に指し示せるものが、名前がない場合は、回りくどい説明になってしまいます。ユーザーのわかりやさ、プラス、サポートの便宜のためにも、ユーザーインターフェイスの設計時には、いい名前をつけてくださいね。

  2008/09/11

• せっせと短くシンプルに（滝田）

  いま、私は「～することができます」と戦っている。…と言うと、なんだか意味不明ですが、要は、改訂中のマニュアルにでてくる「～することができます」という表記を集中的に修正しているのです。きっかけは、先週のTCシンポジウムで聞いた発表。ひとつの文章を、いくつもの媒体（紙・Web・製品への組み込み等）に流用した結果、取扱説明が分かりにくくなってしまったこんな現場を目の当たりにした発表者の方が、画面上で読む場合にふさわしい表現方法として発表されていたのが、文章の「短文化」です。たとえば、「～することができます。」という文章を、「～できます。」と書き換えれば、文字量が少なくて済みます。一般的に言われているのは、紙に印刷された文字よりも画面に表示された文字のほうが、読む側の負担が大きいということ。今回、制作中のマニュアルはPDFとして配布されるので、「なるべく短く。なるべくシンプルに。」を心がけて文章を見直すことにしました。※ 画面で見るのと、紙ベースで読むのとは、目に飛び込んでくる情報のかたまりが違うのだそうです。そうして改めてマニュアルを見直すと、修正したい箇所がわんさか。長）～することができます。～しておくことができます。短）～できます。長）～を変えることができます。短）～を変更できます。長）～から選択することもできます。短）～からも選択できます。長）～しておくことができます。短）～できます。長）～を行えます。短）～できます。長）検索したり、閲覧したりする場合に、短）検索・閲覧する場合に、ただし、●●もできるけど、■■だってできるんだよ～というニュアンスの文章では、意味を強調させるために「～することができます」をそのままにしている場合もあります。なにごとも、場面に応じて臨機応変に...ですね。

  2008/09/03

• マニュアルにユーザーへの思いを詰め込んで（滝田）

  昨日・今日と、東京で開催されたテクニカルコミュニケーションシンポジウムに参加してきました。「取扱情報のあるべき姿とは」「取扱情報の分かりやすさとは」ということが、シンポジウムの一貫したテーマです。会場にはマニュアルの現物も展示されているのですが、その中に、こんな一冊を見つけました。●音声読み上げソフトのマニュアル音声読み上げソフトというものを、ご存知でしょうか？パソコンのテキストを音声で読み上げるアプリケーションで、弱視の方でもパソコンを使うことが出来るように開発された製品だそうです。展示されていたのは、その紙マニュアルでした。それは、言ってみれば、目がよく見えない方が読むマニュアル。一体どんな内容なのだろうと興味を持ってめくってみたところ、その内容は、非常に吟味されたものでした。たとえば、・ユーザーと支援者の操作を切り分けて解説する・ユーザーの操作は、マウスを使わない方法で説明する・弱視の方が見やすいよう、配色とコントラストに配慮・文字よりイラストで説明する （例：高速再生はウサギマークのボタン、低速再生はカメマークのボタン）やはり、ユーザーが１人ですべての操作をすることは難しいので、セットアップやもしものときは、周りにいる人にスムーズに手伝ってもらえるように、ユーザー用のページの隣に「支援者の方へ」というページが用意されていました。＃ マウスでクリック…という一見普通の操作も、＃ 目が見えるからこそなのだなと、＃ 恥ずかしながら初めて気がつきました。●最も印象的だったことマニュアルの表紙をめくって一番初めのページ、「はじめに」にあたる文章です。「この製品を手にとってくださったあなた、はじめまして。」手紙のような口調で、ユーザーに直接話しかけるように始まったり、「わたしたちは、あたなのお手伝いがしたいんです。あなたがパソコンで開いた文書を、パソコンが読み上げてくれたら、ちょっと素敵だと思いませんか？」文章自体は正確ではありませんが、確かにこんなニュアンスでした。なによりも、不安を持つことなく、楽しく気持ちよく使ってほしい…そんな思いを全面に出したマニュアルです。●単なる「使い方の説明」を飛び越えて無味乾燥の操作情報だけが、マニュアルではない。マニュアルに、その会社の製品への思い、使ってくれる人への思いを表現することができる。不安を減らして、挑戦意欲をかきたてることができる。音声読み上げソフトのマニュアルは、そんなメッセージが表現されている一冊でした。よーし、わたしも、製品の作り手と使い手を繋ぐようなマニュアルを制作しなくちゃ！と、襟を正した滝田でした。

  2008/08/27

• 独断的・テクニカルライター業界用語（滝田）

  【その1】 嵐の前の静けさマニュアルのプロジェクトが動きだす直前の時期のこと。注文書が届き、受注が決まり、あとは製品が届くのを待つばかりの状態を指す。この間にスケジュール案、目次案、デザイン案などを作成し、クライアントに提案する。仕様書を読み込んでおくのも、この時期。-------------------------------------------------（ 社内ウラ話 ）今、まさにその状態です。（ご発注、ありがとうございます!）毎年、夏になると社内ではマニュアルのプロジェクトが複数動き出すのですが、この時期、滝田はお祭り前夜のような気分。こころ落ち着けて、スタートの時期を待ちます。今年もがんばるぞっ　　（どきどき…）連日、製品と向き合ったあの日々。暑さと戦いながら、仕様書をファイリングしたあの日々。さなかにいる時はなかなか気合いが必要だとしても、今ではなんだかそのキツさが楽しみなのでした。【その2】 台風の目クライアントの方が、校正してくださっている期間のこと。初校や再校を出すまでは、締め切り死守！という意識が働くため、根を詰めた作業の日々がつづく。しかし、校正にだしたとたん、ぽっかりと手が空いたような錯覚に陥ることも。複数のマニュアルを同時進行させる場合は、この「台風の目」を作らないようにスケジュールを立てることもミソ。-------------------------------------------------（ 社内ウラ話 ）マニュアルを校正に出している間は、もちろんそのほかの業務に励みます。でも心の中では、マニュアル、はやく戻ってこないかなぁと、校正中のマニュアルを恋しく思う時期でもあるのです。もはや、恋！？今年もアツ～い夏は、すぐそこまで来ています。

  2008/07/23

• テクニカルライターの素養

  作家の村上龍さんが、子どもたちに向けて仕事・職業を紹介している本13歳のハローワークたくさんの職業が掲載されていますが、残念ながら、といいますか、やっぱり、といいますか「テクニカルライター」は掲載されていません。（「ウェブデザイナー」は載っているのに）「13歳のハローワーク」は自分の好きなものから、仕事を検索できるようになっていて、算数･数学が好き　　↓金融業界で働く/税理士/公認会計士・・・という具合です。この形に則って「テクニカルライター」を掲載するとすると、もちろん、最初に挙がるのが「文章が好き」ということ。このほかに、興味の対象がどんなことだとテクニカルライターに向いているか考えてみました。●新し物好きテクニカルライターは、開発途中の製品や最新技術に直接触れられる、新し物好きには、たまらない職業。●人の役に立つのが好き「分かりやすさ」を追求する原動力だと思います。●空想が好きどんな人が、どんな風に使うのか分析したり、実物がない状態で、頭の中だけで正しい操作手順を組み立てたり、製品の一箇所の仕様変更が、全体にどう影響するのか、マニュアルのどの部分を修正する必要があるのか、常に想像しています。●長時間、机に向かうのが好き（平気）執筆・DTP・校正は、時間のかかる地味な作業。でも、ここに楽しみを見出して丁寧にこなすことが、マニュアルの質を支えます。マニュアルは、新しいサービスや製品には不可欠なもの。将来、「13歳～」が改版することがあれば、ぜひぜひ、「テクニカルライター」の掲載をお願いします。

  2008/07/18

• マニュアルの制作スケジュール（下田）

  ひとつのソフトウェアで、数種類のマニュアルを制作したり、マニュアルとヘルプの制作を、同時に任せていただけることがあります。このとき、制作スケジュールをどう組み立てるか。たいていは、校正がマニュアル同士で重ならないように、まず、1つ校正を出して、それがバックされるタイミングで、もう１つの校正を出し、片方を校正していただいている間に、もう片方を修正する、という組み立てになります。このやり方だと、校正の負担を分散することができ、校正にかかる時間を調整しやすくなります。ただ、すべてを同時にチェックできないので、同じ機能なのにマニュアルとヘルプとで校正指示が違う、などということが起こりがちです。分担して制作しているライター同士が連携して、先に修正指示が出た部分は、後で提出するものにも反映してから出したり、用語や表現の細かな統一に気を配る必要があります。校正をすべて同時に行うようにすると、内容を同時にチェックできるので、校正指示のズレを防ぐことができますし、分冊や、マニュアルとヘルプで、カバーする範囲や役割を区切っているときは、同時に見比べながら内容を判断できます。ただし、校正のタイミングをぴったりと合わせると、1回の校正の負担が重くなり、校正提出からバックまでに長い時間が必要です。そのため、スケジュールがタイトなときには、この方法は選択しにくいのです。まったく新しい製品の初めてのマニュアルでは、なるべく同時に校正できるように、反対に、バージョンアップを重ねてきた製品でマニュアルの内容もそれほど変更がない場合はスケジュール重視の時間差校正で、など意識して組み立てる必要があります。

  2008/07/03

• マニュアル作りの相互作用（滝田）

  いま、メディアリュウムではマニュアル制作のシーズンが到来しています。そして、マニュアルを作ることが、私の仕事です。ですので、いま、私は水を得た魚のよう♪どんなにタイトなスケジュールであっても、「メディアリュウムに頼んでよかった」と思っていただけるならば、力が沸いてきます。でも、マニュアル制作のシーズンが好きなのは、それだけの理由ではないのです。たとえば、製品についての質問があったため休日にクライアントの方に電話してみると、かならず通じる。原稿を提出すると、すぐに見て、確認して連絡をくださる。そんな小さな体験を重ねると、マニュアル制作ひとつとっても、1人で仕事をしているわけではないんだなーということが、とても良くわかります。まことに勝手ながら、いっしょにがんばろーーーー！という気持ちに、ものすごく、なります。そんなわけで、マニュアル制作のシーズンは、私の大好きな時期なのです。そんな私の、ある晩の寝言（実話）。私　 ： （突然）消さないで！夫　 ： なにを？私　 ： データ…夫　 ： なんのデータ？私　 ： マニュアル…（再び寝入る）文字通り、寝ても覚めてもマニュアル制作です(^^;)>

  2008/06/18

• 地味だけど、便利なこと（下田）

  最近知って、すごくうれしかったこと、それは、Adobe IllustratorとAdobe Readerとで、お互いのファイルを開けるということ！Illustratorの拡張子「.ai」のファイルをAdobe Readerで見たり、PDFファイルをIllustratorで開くことができるんです。これが、なぜうれしいかと言うと、Adobe Illustratorがインストールされているパソコンは少数派。でも、Adobe Readerは今やほとんどのパソコンに入っています。（入ってなかったら、ダウンロードすればいいし）今までなら「aiファイルは、このパソコンでは見れないや」とあきらめていた状況でも、とりあえず、内容は確認できるのです。また、自分が使っているIllustratorよりも、aiファイルを作ったIllustratorの方が新しくて自分のパソコンで開けないときは、一度、Adobe Readerでaiファイルを開き、それをPDFファイルとして保存すると、自分のIllustratorで開けます。パスも、ちゃんと保持しているんですよ。知っている人には「今頃、なにを言ってるのサ」と呆れられてしまいそうなのですが、便利で、うれしい新発見でした！

  2008/06/13

• 瞬発力とバイリンガルの素質（滝田）

  テクニカルライターの必要要件を考えてみました。・情報を整理する力がある・誤解なく伝える文章表現力がある・短い制作期間でも、質の高い制作物に仕上げるド根性（？）などなど。しかし、今の私に最も必要なのは、頭をぱぱっと切り替える瞬発力です。というのも…CD-ROMを入れても、何も反応しない！まさか、壊れてるのか！？と、思いきや、Macintosh用のデータCD-ROMをWindowsで読み込もうとしていた…orz　その数分後、キーボードが反応しない！なぜだっ！画面をにらんでキーボードを連打！と、思いきや、Windowsのデスクトップを見ながらMacintoshのキーボードをたたいていた…orz※ おまけに、Macintoshの画面には、意味不明な文字列…なんだかもう、いろいろ混ざってますね(^^;)さて、MacintoshとWinodows…といったOSだけの問題ではなく、マニュアルを作る場合、制作ツールにも似たものがたくさん。▼メディアリュウムの場合Macintosh・QuarkXPress・Adobe PageMaker・Adobe Photoshop・Adobe IllustratorWindows ・Microsoft Word・Adobe PageMaker ・Adobe FrameMaker・Adobe Indesign・Adobe Photoshop・Adobe Illustrator制作会社として、お客様のニーズに応えられるよう、多種多様な制作ツールをそろえておくことは大切。しかし、瞬時に頭を切り替えて、複数のソフトを使いこなすことは、なかなか至難の技なのです。目的はだいたいどれも同じ。基本的に似ている。でも、みんな少しずつ違う。そんな手ごわい制作ツールたちは、まるで、語学のようです。テクニカルライターには、バイリンガル（いや、それ以上？）の素質が必要なのかもしれません…(^^;)>

  2008/06/04

• マニュアルキャンペーン、その後（滝田）

  世の中、こんな仕事もあるんだよマニュアルって、案外あなどれないよということを知ってほしくて、昨年の秋から企画をし、2008年開始と同時にスタートした「マニュアル無料診断キャンペーン」。キャンペーン期間は終わってしまったけれど、私のマニュアル診断はまだまだ終わりません！本日は、キャンペーン期間終了後に、私達が何をしていたかをご紹介します。■ メディアリュウムにある日届いた、大きなダンボール箱箱を開けると、中には導線がたくさん付いた機械やケーブル類が、どっさり！「製品とマニュアル、取りに行きます」と言ったところ、お客様自ら宅配便で送ってくださったのでした。ありがとうございますm(__)m■ どんな機能があるのかな（機能分析）どのような製品か理解せずに、マニュアルだけを診断することはできません。とにかくまずは、製品の分析から。機能をすべて書き出します。分からないことは、ネットで調べながら、まずは自力で進めます！■ どんな順序で使うのかな（時系列分析）ある程度、すべての機能を理解したら、次に重要なのは順番です。マニュアルを書くときは、・1番初めに行わなければならない重要なこと・たまに、行う重要なこと・場合に応じて、行うことなどなど、マニュアルに記載する内容を、時系列で考えることも大切。そのため、お客様が製品を購入して、日常で使うまでの流れを綿密に想定します。今回は、使う前に製品を設置する必要があるので、机の上に本体やケーブルを並べ、「これはあっちに。これはこっちに…。」と、ひとり製品を組み立て。どうしても分からないことは、お電話でお客様にお聞きしました。電話しながらメモを取ったため、見直すとメモ用紙には魔可不思議な配線図が･･･。■ お渡しできるよう、ひとつの形にまとめます製品の分析を終えたら、いよいよお客様にお渡しする診断書を作ります。今回は、マニュアルの問題点と改善案をまとめたほか、こうしたらもっと分かりやすくなるんじゃないかという、目次案とレイアウト案も作成。作り始めると楽しくなってきてしまい、上司と相談しながら更に思いついたアイディアを書き加え･･･その結果、結構なボリュームになってしまいました(^^;)>■ そして、ついに･･･明後日、お客様に診断書をお渡しします。お客様とは、メールや電話でやりとりしていたものの、お会いするのは初めて。1ヶ月間、びっしりとお付き合いさせていただいたマニュアルのクライアント様にお会いできることは、本当に本当に、楽しみなことなのです。たとえて言うならば…育ての親が産みの親に子をお返しするような心境です｡ﾟ(ﾟ´Д｀ﾟ)゜｡ｳｧｧｧﾝ

  2008/05/07

• 紙面デザインのポイント（下田）

  メディアリュウムのテクニカルライターは、文章の執筆だけでなく、マニュアル紙面のデザインも自分たちで考えています。無味乾燥に思われやすいマニュアルですが、デザインに対する条件もいろいろあります。読みやすく、内容が分かりやすく、情報をさがしやすく、製品の用途やイメージに合っていて、センスのあるデザイン。このような条件をクリアするための基本的なポイントを３つ挙げてみます。●適度な余白がある　まず、紙の縁から本文が収まるスペースまでの　上下左右の余白を、意識して空けます。　そして、段落と段落の間の余白　図やイラストの回りの余白などをどのくらい空けるか　決めます。●読みやすい文字サイズ　小さい文字も、大きすぎる文字も読みにくいですね。　おもしろいのは、同じ文字サイズでも　マニュアル自体の大きさによって、　読みやすさが変わることです。　小さいマニュアルでは、　多少小さめの文字でも　あまり読みにくく感じません。●見出しの装飾やワンポイントのマークなどが　うまく使われている　　マニュアルのイメージを左右することはもちろん、　見出しが目立つかどうかで、　検索のしやすさも違います。※マニュアルを企画して、　デザイン性の高い紙面が相応しい、となったときは、　専門のデザイナーがデザインしています。

  2008/04/10

• マニュアル制作の見える化？（滝田）

  メディアリュウムで好評継続中の、社内勉強会。本日のテーマは、「ITプロジェクトの見える化」でした。見える化とは、プロジェクト進行に関わる問題を「見える」ようにすることだそうです。では、マニュアル制作の見える化とは？？ということで（多少無理やりな感もありますが）今回は、メディアリュウム内部で、どのような流れでマニュアル制作は進行しているか、みなさまに「見える」よう、まとめてみたいと思います。============================================================※ 今回はソフトウェアのマニュアルを想定しています。※ マニュアル改訂時、または納期が短い場合など、　 お客様とご相談のうえ、工程の一部を省くことがあります。============================================================● 仕様書を読む、旧バージョンの製品を操作してみる● 製品について分析製品について理解していないと、効果的なマニュアルは作れません。分析しておく内容は、たくさんあります。- どのような機能があるの？製品のウリは？（機能分析）- どのような人が使うの？（ユーザー分析）- どのような目的で使うの？（利用分析）- マニュアルには、どのようなことが要求される？（要求分析）- それぞれの機能は、どのような順序で使われるの？（時系列分析）ここが、マニュアル制作の最大のキモとなります。● マニュアル全体の目次案を作成し、お客さまに提出● 目次案をもとに、制作のスケジュールを作成。お客さまにも提出。● 紙面のレイアウト案を作成し、お客さまに提出「注意！」や「≪補足≫」などのシンボルマークも作成しますよー。● 会議複数のライターで作業を行う場合は、執筆に入る前に、使う用語や文体などのルールを決めておきます。統一感のあるマニュアルを作成するためには、とても大切です。● 執筆開始いよいよ、執筆開始。ここまでくれば、あとはスケジュールを死守！製品に関する不明点などは、適宜、お客様に質問しています。● 社内校正ボリュームの多いマニュアルほど、書いた部分からどんどん社内のライターに校正してもらいます。執筆→校正→修正→校正　　この繰り返しによって、マニュアルがブラッシュアップされてゆくのです。ツッコミ歓迎！● 初校提出完成したかたちで、一度お客様にご確認いただきます。● 再校提出初校での修正指示を反映させたマニュアルを、再度ご確認いただきます。● ３校提出再校での修正指示を反映させたマニュアルを、再度ご確認いただきます。どんどん完成に近づく！● 確認校提出納品前に、最後の確認をお願いしております。● 納品納品物をもって、御社にお伺いいたします。中身をご確認いただく瞬間は、こちらもどきどき(^^;)納品物をお渡しして、会社へ戻るときは、達成感からしばし放心。こんなとき、よく電車を乗り間違えます…（実話）-----------------------------------------------------------------------なんとな～く、テクニカルライターの仕事をお分かりいただけたでしょうか？たかがマニュアル、されどマニュアル。わたしたち、手間ひまかけて育ててます！でも、見える化って、こういうことじゃ、ないのかも…？？

  2008/04/09

• Word が選ばれたワケ（滝田）

  Wordでも、マニュアルは作れます！ただし、Wordとはもともとワープロソフト。DTP用のアプリケーションではありません、そのため、断ち落としができない･･･など、多少の制限はあるものの、機能を駆使すれば、だいたいのレイアウトは表現できます。※「断ち落とし」について詳しくは、こちら。しかし、中には「あえてWordで作りたい！」という依頼もあります。それは、どういう時かというと･･･お客さまが後に自分でマニュアルのデータを修正するかもしれない場合です。Wordであれば、大抵の人が使い慣れているので、ちょっとした製品のバージョンアップであれば、マニュアルの修正は自分たちで対応できてしまう。ここら辺をぽろっと忘れると、今回のようなことが起こります。---------------------------- 今回のようなこと ----------------------------Wordでマニュアルを制作していた、ある日。表紙はいわば、マニュアルの顔。第一印象はよりよくしたいな～との思いから、表紙のタイトル部分を、グラフィックソフトで画像として作成。Wordでは使っていない、特殊なフォントを使って作りこむ。えへっ、かっこよくなったかも～♪と、その画像を表紙の中央に置いたところ…納品後、お客様より修正の依頼が。「表紙の文字を修正したいのですが、私たちではできないので…」とのこと。確認すると、修正したい箇所とは、画像の中の文字。お渡ししたのはWordのデータだけなのだから、たしかに修正できない･･･ orz-------------------------------　おわり　--------------------------------「自分たちで直せたら便利」というお客さまの希望と、「Wordでもできるだけ見栄えよくしたい」という制作側の意図がうまくかみ合わなかった一例として、しかと心に留めておこうと思いました。どのような意図でその制作ツールが選択されたのか、ここを見誤ると、このようなことが起こり得ます。Wordに限らず、常にその制作ツールを使う意味は？？と、考えてみることは大切ですね！

  2008/03/26

• 書けないときはジタバタ（下田）

  雪が少なかった札幌にもとうとう、ドカ雪が降りましたね。私は夕方に車を運転していて、積もっている雪にハンドルを取られてしまいました。超・ノロノロ運転だったので車はすぐに止まり、突っ込んだり、ぶつかったりはしませんでした。ホッ。でも、このごろ、日の出が早くなってきたと感じています。雪や寒さは、まだまだこれからですが、春は近づいてきていますね。さて、マニュアルを書いると、どのような流れで説明するといいかわからない、うまい解説が思い浮かばない、などと執筆が進まなくなるときがあります。そういう時はどうするか。私の場合は、●むずかしところは、ひとまず置いておいて　他の書きやすいところを書いていく。　そうして、集中してリズムに乗ってきてから　難しいところに取り掛かると、　よいアイデアが出やすい。●「ヘタクソな説明だなあ」と思いながらも、　とにかく思いつくままに書いてみる。　書いたり、削ったり、入れ替えたりしながら、　じわじわと作り上げていく。●ほかのライターに相談する。　同じマニュアルの担当同士はもちろん、　その製品に関わっていなくても　似た事例を知っていたり、　違った視点での解説を提案してくれたり、　やっぱり仲間は頼りになります。頭の中で考え込まずに、とりあえず書いたり話したり、外に出していくことがポイントのようです。　　

  2008/01/24

• 工業デザインは、マニュアル道にも通ず（滝田）

  先日読んだのが、この本。『デザインにひそむの法則』木全賢 著　ソフトバンク新書「工業デザインとは何か？」をテーマに、デザインの初心者向けに書かれた本です。パソコン、プリンタ、卓上ライト、携帯電話…私たちの身の回りにあるほとんどの物が工業製品であり、そのためのデザインが「工業デザイン」だそうです。それならば、きっと「使いやすさ」と「分かりやすさ」が重要視されるはず。そこが、マニュアル道に通じるのでは！？と思い、手にとってみました。※ 以下、マニュアル道の琴線にふれた部分を、ご紹介いたします。------------- 「第三章 美しさと使いやすさの法則」より -----------------------------人が装置（外界）に対して何かを行おうとするとき次の四つの原則が守られていないと、それをスムーズに行なうことができない」（P.86） 四 つ の 原 則 と は ・・・？１．可視性　次に何をすればよいか、ひとめで分かること　　 　 　　 （Ex.ボタン→押す、鍵→鍵穴にさして回す）２．対応づけ　原因と結果が自然に理解できること　　 　　　　 （Ex.ハンドルを右に回す→右に曲がる）３．概念モデル　経験の蓄積からできあがった標準的なパターンと一致していること　　　 　　　　　 （Ex.ゴミ箱にごみを捨てる⇔ゴミ箱のアイコンに不要なファイルを捨てる）４．フィードバック　ある行為の結果が、ただちに明らかに示されること　　 　　　　　　　 （Ex.スイッチを押す→すぐに電気がつく）---------------------------------------------------------------------------これらの４つが重要なのは、マニュアルを書く上でも同じです。ユーザーが製品を使おうとマニュアルを開いたとき、この四つの原則が守られていないと、操作をスムーズに行うことができないのです。●マニュアルでの「可視性」とは細かな手順を説明する前に、操作のおおまかな流れを示すこと。これからどんな操作をするのか、あらかじめ示しておけば、「次になにをすればよいか分からない！」と、迷子になる心配も少なくなります。●マニュアルでの「対応づけ」とはユーザーの操作と、操作の結果をきちんと分けること。「××ボタンをクリックすると、○○ダイアログが表示されるので、△△を選びます。」これは、悪い例です。クリックするのはユーザー。ダイアログを表示するのはプログラム。ここをキチンと分けないと、ユーザーが混乱する原因になってしまいます。●マニュアルでの「概念モデル」とは一般的な操作の順番どおりに書くこと。ソフトウェアの場合、まず製品をパソコンにインストールしてからでないと、使えません。そのため、マニュアルでは「インストール」から書くのがキホンです。「インストール」が別紙で説明されている場合、つぎに行う操作は「起動する」ですよね。●マニュアルでの「フィードバック」とはユーザーの操作と、操作の結果をきちんと１：１対応させること。ユーザーがクリックしたら、クリック直後の画面がどう変わるのかを書くのがキホンです。自分で操作した結果がマニュアルと違っていれば、ユーザーは不安になってしまいますよね。こうしてみると、工業デザインもマニュアル書きも、「使うひとに分かってもらうこと」が重要という点では、同じなのかもしれませんね。------------------------------------------------------------------------日々こんなことに気をつけながら、私たちはマニュアル制作にはげんでおります。そして…ただいまマニュアルキャンペーンを実施中です！詳細はコチラから♪

  2008/01/23

• ピン！とくるマニュアル（下田）

  娘が最近、しゃれのポイントをわかるようになってきました。今までは、「なんでおもしろいの？」と訊ねていたのが、このごろは「これは、○○のことばを○○みたいに使ってるからおもしろいんでしょ？」と説明してくれます。（でも、まだ、確信は持てないので、質問形）しゃれは、言葉の意味や、言い回しをあらかじめ知っていなければ楽しむことができません。また、ポイントを説明されても、面白さを感じることは難しいでしょう。マニュアルの解説のしかたでも、読者の背景を理解して、読者の知識や習熟度に合わせて説明をしないと、論理的には正しく書いてあっても、ポイントが伝わらなかったり、逆に、回りくどくて読者を飽きさせてしまうものになったりしてしまいます。読んだ人が読んだとたんに「ピン！とくる」解説を書くために、読者像を明確にしておくことが重要です。

  2008/01/10

• 人の振り見て（下田）

  メディアリュウムのマニュアルやヘルプには、意識して作ったルールと、チームでの制作を長年経験していくうちに自然に出来上がった流儀のようなものがあります。そこに、クライアントで採用している規則に従い、さらに、対象製品にとってふさわしい表現（子ども向け製品は親しみやすい口調で、　ビジネスシーンで使われる製品は簡潔に、など）を考えて制作していきます。今年、わたくし下田は、ヘルプの改訂をいくつか担当させていただきました。これまで、Windowsのアプリケーションで使用されてきたWindowsHelpが、新しいOSであるWindowsVistaでは使用できないため、HTML Helpという形式に作り変える、というものです。もとのヘルプは、他社様で制作したものがほとんどで、さまざまなヘルプの文章と、じっくり付き合うことができました。真似をしたいと思うほど、わかりやすくてよい文章があったり、「自分では、こういう書き方にはしないなあ」と思う表現があったり。自分（メディアリュウム）の書き方というものを意識し、わかりやすい表現を考える上での刺激になりました。来年のメディアリュウム、ますますわかりやすいマニュアル・ヘルプを作りますよ！

  2007/12/20

• 一人前にしてみせます（滝田）

  製品の操作マニュアルとは、「ユーザーにストレスを与えることなく、必要とされる情報を供給すること」ができてこそ、一人前だと思っています。※ 製品に興味を持ってもらう…など、それ以外の付加価値をつけるのは、テクニカルライターの腕の見せ所です。がんばります。初めて書いた原稿は、言ってみれば、生まれたての赤ちゃん。赤ちゃんなので、まだ人に何かをうまく伝えることができません。そこで、テクニカルライター母さんは、・文字が詰まっていて読みにくくはないかな？・不足している情報はないかな？・表記のルールは統一されていいるかな？などと、よくよく面倒を見て、育ててあげる必要があります。しかも、メディアリュウムのテクニカルライター母さんは複数おりますので、より多くの目で育てていくことができるのです。わが子（自分で書いた原稿）が校正を経て、赤ペンで真っ赤になって帰ってくるときは、やっぱり少しひるむのですが、それも皆「この子たちを一人前に！」という思いがあるからこそ。校正→修正→校正→修正この過程を経て、赤ちゃんは生まれ変わります。情報の固まりがきちんと整備され、用語も統一されたマニュアルは、品良くページの中に収まって、とてもお行儀が良い。テクニカルライターとして（それがたとえ超がつくほどの新人でも）段階を追うごとにマニュアルが成長していく姿を見るのは、とてもおもしろいことです。「お嫁（納品）に行っても、お客様の役に立つんだよ」という気持ちを胸に、今日も原稿を修正するのでした。ソフトウェアの開発会社さま。御社の操作マニュアルは、一人前ですか？それとも赤ちゃんですか？わたしたち、テクニカルライター母さんが、大事に育ててみせましょう！里子に出したい方は、どうぞご連絡くださいませ

  2007/12/19

• 目次を活用しよう（下田）

  マニュアルにとって、目次はとても重要です。目次は、いろいろな役割を果たしています。■目次はマニュアルの要約です　タイトルは、解説内容を一言で表したものですから、　それらの集まりである目次は　自然とマニュアルの要約になります。　逆に言うと、　目次からマニュアルの中身が分からない場合は　マニュアルの構成か、タイトルの付け方が　よくないということになります。■目次は、製品やサービス全体の流れや　しくみを示します　これは、メニュー順など一定の規則に沿って　解説しているマニュアルなどには　当てはまらないのですが、　利用上の自然な順番にしたがって解説しているマニュアルでは、　目次を見ると操作の流れをつかむことができます。■タイトルはキーワードです　よいタイトルは、機能の内容だけでなく、　重要度や、　その機能を使う利点、　目的などを伝えることができます。　ですので、マニュアルの目次を作るときには説明の順番を決めるだけでは不十分です。ユーザーが求める情報を探しやすくするため、関連のある項目を一箇所に集めたり、階層のつけ方に注意を払う必要があります。さらに、解説の内容や機能の目的、ユーザーへの注意などがよく伝わるようにタイトルの表現を工夫するべきです。立場が変わって、マニュアルを読むときにはまずは目次をチェックして製品やサービスの全体像を把握すると、以降の理解が早くなりますよ。

  2007/12/13

• 校正は宝ナリ（滝田）

  夏から作業していたマニュアルが、本日納品となりました！わー！こんな日にブログ当番があたる私は、なんて幸運なんだろう上司から「目次案を作成してください」という指示を受けたのが、数ヶ月前。山あり谷あり、何から何まで初体験・日々是勉強のマニュアル制作でした。ひとつのお仕事を終えて、改めて思うこと。マニュアル制作は、お仕事をご発注いただいたお客様との共同作業だ！マニュアル制作が佳境に入っているときは、製品開発だって同じだ！（･･･本当だったんだなぁ。みんなでがんばるんだなぁ。）タイトなスケジュールの中で、いかに満足していただけるものを作成するか。これがプロとしての腕の見せ所だと、改めて感じました。※ その点、私はまだまだなので、周囲の先輩方にものすごく助けていただきましたこれが、私のテクニカルライターとしての始めの１歩。1冊のマニュアルを作成すると、10冊の本を読むよりも、100倍勉強になる。机の引き出しにしまってある、校正で真っ赤になった原稿を眺めて、そんな風に思った今日この頃です。※ もちろん、本を読んでの勉強もたいせつですが・・・今回の経験をむだにせず、まずは反省。そして次に繋げていきたいと思います。あっ、テクニカルライターの７不思議のひとつも、ちゃ～んと体験済みです↓　↓　↓　↓　↓　↓　↓　↓　↓　↓　↓　↓　↓　↓　↓　↓　↓　↓　↓ものすご～く悩みながら書いた部分ほど、仕様変更の標的となる（つまり、カット）。残りの６つ（なんだろう???）は・・・これからのお楽しみです。

  2007/11/28

• マニュアルがつまらない理由（白藤）

  マニュアルがつまらない理由。それは、執筆した人が、つまらないと思って書いているのではないか。そんな気がしてならない今日この頃。・人はどのようにして新しいことを 学んでいくのか、・理解しやすいレイアウトは何か。・読みやすい文章とは...このようなことを突き詰めて考え、マニュアルを設計したら、ひとめ見ただけで、「読みたくなーい」と感じるマニュアルは出来上がらないと思うのです。読みたくない方は、まぁどうやっても読みたくないかもしれませんが... (>_

  2007/11/26

• 導入マニュアルに欠かせない情報（下田）

  経理の仕事で新たに必要になったソフトウェアがあり、今日、インストールをして使い始めようとしたのですが、マスタ設定のところで、つまずいてしまいました。コード番号のようなものを入力する必要があるのですが、何を入れればよいのか、わからないのです。「これか」と思うものをいくつか入力してみましたが、ソフトウェアはどれも認めてくれません。Windowsが広く普及して、ユーザーインターフェイスはずいぶん統一され、操作方法に迷うことは少なくなりました。でも、マスタ設定や環境設定には、ソフトの操作方法だけでなく、設定に必要な情報を入手しておくことや、設定する項目の順番を間違えないことが大事な場合があります。これらは、個々のソフトウェアによって独自のものであり、いろいろなソフトウェアを使った経験があってもわかりにくいところです。マスタ設定や環境設定を解説する導入マニュアルには、はじめに設定の順番を示す。または、設定すべき順番を守って解説する。設定する項目の意味や目的を補足する。必要な情報の入手先を示す。などの心配りが求められます。さて、私は、付属のマニュアルを見てみましたが解決しないため、明日、サポート窓口に電話をしてみます。ユーザーのいらだちを実感できてよい体験だと思うことにしましょう。

  2007/09/27

• 愛のムチ（下田）

  他のライターの原稿を校正していて悩むのが、「正しく書いてあるのだけれど自分は違う書き方をするかな」という、微妙な箇所。最初に書いたライターも、じっくり考えた末の原稿なわけですから、チェックを入れるにしてもちゃんと説明しないといけないと思いなぜ、その箇所がひっかかるのか、とか自分ならどう書くか、とかいろいろ考えて、赤ペンで書き込みます。すると、そういうページは、大抵、真っ赤になってしまいます。（余白が足りなくなって、紙を継ぎ足すことも）自分が真っ赤な校正を受け取る立場になるとやはり、がっくりきてしまうのですが、校正者の意見に納得したら、素直に書き直せる。そうすると、確かに、前よりもわかりやすくなっています。校正する方もされる方も、互いにしんどい作業ですが、メディアリュウム社内は真っ赤な校正が行き交っております。

  2007/09/13

• マニュアルはどこから書くべきか（下田）

  新しいマニュアルの企画がまとまり、さあ、書き始めるぞ！となったらまず、目次をにらみながら何日にはどこを書くか、という計画を立てます。マニュアルは、どこから書いていくべきか。基本は、やはり、目次の最初の方から順番に書き進めるべきでしょう。マニュアルの最初の方では、システムの概要やしくみの紹介、用語の定義などが行われます。その、土台の部分を書き上げてから、それらの前提条件にのっとって各機能の解説を書いていきます。土台がしっかりしていないと、書いていくうちに解説の仕方がずれてきて、一度書いたところを書き直す、という羽目になることもあります。ただ、自分の場合は、この「目次の順番に書く」に加えて、書き始めの数日は、目次の順番とは無関係に、書きやすそうなところも混ぜて執筆の勢いをつける、ということもしています。自分は、最初のうちは、書くペースが遅いのです。書き進めるうちに、スピードが付いてくるのですが。そのことに気づいたときから、最初はペースが遅いと分かっていても、「執筆済み」の項目が増えないのも精神的に良くないので、「目次の順番」8割、「好きなところ」2割くらいでやりくりしています。ほかのライターの皆さんも、きっと、自分の流儀があるのでしょうね。

  2007/09/06

• 具体例を使う（下田）

  マニュアルで新製品や新機能の紹介を書いていて、どうもうまく説明できない書けば書くほど難しく見えるというときがあります。そういうときは、機能のしくみについての解説はいったん引っ込めてどういうときに使う機能なのかその機能を使うとどういう風に便利なのかという身近な例を挙げて解説を組み立てていくと分かりやすくなることがあります。テクニカルライターたる者どんな場面にも当てはまる一般化した解説を目指したいのですがそれに縛られてかえって分かりにくくなってしまっては本末転倒マニュアルを読んだ人が最短距離で理解できる解説方法を見つけることこそが大事。ライティングの基本や約束事を大事にしつついろいろな視点で考えて執筆する姿勢が求められます。

  2007/08/30

• 声を集める（下田）

  テクニカルライターになりたての頃は、私は、ソフトウェアのメーカーで、自社製品のマニュアルを作っていました。社内には、ユーザーサポートの部署があり、問い合わせの多い事柄などが、自然に伝わってきました。ユーザーの方からの質問に答えたり、展示会などで直接、お客様とお話できる機会もあり、それらが、マニュアルを「もっとわかりやすく」する推進力のひとつになっていたように思います。一方、メディアリュウムでは、他の企業から任せていただいた、マニュアルを制作していますので、納品後のマニュアルが、どのように読まれているか、ユーザーの方の評判はどうなのかを、直接的に知ることは、難しいです。ちょっと、寂しい。マニュアルの企画をするときには、意識して、ユーザーのつまづきそうなところ、問い合わせの多い部分をクライアントから聞き出します。また、普段は、いろいろな業種の人が、パソコンをどう使っているか、見たり聞いたりするように心がけていると、正しいユーザー像を作りやすくなると思っています。ユーザーの方々には、マニュアルへの意見や文句を、どんどんメーカーへ伝えていただきたいな、と思います。声がたくさんになれば、それが、マニュアル制作会社に伝わって改善につながるかもしれません。

  2007/08/23

• テクニカルライターの条件 -- 常に自分を疑う -- （白藤）

  いったん涼しくなった札幌... やっと息を吹き返した白藤です。だから、昨日・今日の暑さには、負けない（笑）マニュアル制作に関わってつくづく思うことは、自分を常に疑うというか、チェックする姿勢を忘れないことが大事だということです。最後の最後まで、何か問題はないか検証する姿勢が必要なのです。とくに、新製品の場合は、マニュアルに着手した段階と、納品する頃の段階では、仕様が一部変ったり、画面が変ったりすることがよくあります。いったん修正しても、安心せずに念入りにチェックする。時間との闘いにもなるので、どこまでチェックするか、そのときで深さも違いますが、基本はいつも自分を疑って、見直すこと。これがミスをなくす基本姿勢。さらに、新製品の場合の難しいところは、実物が動かないので、想像力が必要になってくること。そして、その想像したことを、言語化して文章で表すことなのです。そのために、参考になる製品を操作して機能を推測したり、技術文書から操作手順を考えて、何度もシミュレーションする必要があります。また、頭の中で考えてた過程が、すべて文章化されているのか、客観的に読んでチェックすることが必要です。操作できるものは、操作しながら自分の文章を疑いつつ読む。操作できなくても、自分の文章を疑いつつ読む。そうして、第三者に校正に回して、チェックしてもらう。厳しい意見に負けずに、文章を書き直す。想像 → 文章化 → チェック →第三者校正 →原稿修正どこまで、このサイクルを粘り強くできるか。これが、良いマニュアル書きになる条件だと思います。

  2007/08/20

• 人間、やればできる。（滝田）

  夏は、マニュアル制作の季節。と、いうことで、私も実践的にお勉強させていただいています。今回の課題は、内容を変えることなくページの枚数をスリムにすること。むむぅ･･･どこを、どうやったら、いいんだろう。余裕のある余白を削ったり、レイアウトを工夫したり･･･あれこれ手をくわえた結果、どうにかにおさまった！そう思って上司に持っていったところ、言われたのがタイトルの一言。「人間、やればできる。」しかし、この話には続きがあったのです。よく見ると、出来上がったマニュアルは、「ページ数を減らさなきゃ！」という気持ちが先行して、文字のサイズをものすごーーく小さくしていたのでした。「若い人なら見えるけど、年配の方には見えない人もいるよ」そう指摘をうけ、はっとしました。ページ数の指定は、マニュアル制作者の都合。マニュアルを使う人にとっては全く関係のないこと。常にユーザーの側に立って考える言葉にするのは簡単ですが、ちゃあんと反映させないとね。※その後、上司にササッと手直ししてもらったところ、　工夫すれば一回り大きな文字サイズ入るじゃないですか。　「小さくしなきゃ」という気持ちがつっぱしって、　 試してみなかったんですね。やればできたのに。　まずはやってみなくちゃ「やれば出来る」ということすら分からない　身をもって実感したできごとでした。　

  2007/08/08

• マニュアルのおへそ（滝田）

  入社以来、継続してやっていることがあります。それは、マニュアル制作のイロハが学べる本を読んでお勉強すること。　『マニュアル制作の技術』　 NTTラーニングシステムズ株式会社17年ほど前に出版された本なのですが、これが、とても勉強になります。手元に持っていたいかも…と思い、Amazonで検索してみると、５万！ごまんえん！（もともと定価がそのくらいだったようです；）…覚えるくらい読めばいいんです。------------------------------------------------------------さて、こまかな制作技術はさることながら、この本が最も強調しているのは、テクニカルライターは執筆だけしているわけじゃない！ということのような気がします。情報収集・分析・企画・構成・表現設計…etc実際に書きだす以前の作業は、たくさん。これらの作業をどれだけ綿密に、どれだけ深く行えるかが、マニュアルの質を左右するようです。「テクニカルライター」の概念、ここに見たり。テクニカル（technical）とは、１、技術的な、技術上の２、専門的な、専門上のという意味があります。それをふまえて「テクニカルライター」とは、１、技術的な＜手法＞で書くことのできる人２、専門的な＜内容＞を書くことのできる人でしょう！単に「マニュアルを書く人」から「綿密な工程をへてマニュアルを書く人」へ、「テクニカルライター」という意味が、バージョンアップしたのでした。

  2007/07/25

• 理解して好きになって書く（下田）

  マニュアルの制作では、たいていの場合、ページ数を少なくすることが求められます。厚いマニュアルが嫌われる理由としては、次のようなことがあります。■ユーザーから見て厚いマニュアルは・とにかく、読む気がしなくなる・知りたい情報が探しにくくなる・本棚で場所をとる■メーカーの立場で厚いマニュアルは・制作費がかさむ　（マニュアル制作は「ページ単価×ページ数」の料金体系が一般的）・印刷費がかさむ・在庫を保管するにも余計に場所をとるなどなど。そういうわけで、マニュアルを作るときは企画設計段階から始まり、簡潔な文章表現レイアウト上の細かな工夫まで、さまざまな場面で、無駄にページ数を増やさないよう心がけております。ところが、これとは反対に、必要なページ数を埋めることができず、苦労することもあります。製品に付属するマニュアルではなく書店で販売される活用本などは、ある程度のページ数が求められます。ひよっこライターのときには、そういう種類の書籍の執筆中に、どうしても書くことが見つからず、休日出勤でひとりきりの会社で泣いたこともありました。ページ数を抑えるにしても、たくさん書くにしても、「対象への思い入れ」を持ち「読者へ伝えるべきことは何か」を分かっていることが大切です。それがないと、壁に突き当たったときに正しい解決ができません。必要な情報が不足していて、製品を正しく使えないマニュアルになったり、ピントのずれた本になってしまうかもしれません。今、振り返ると、ひよっこライターで泣いていたときは対象への思い入れが足りなかったのでした。製品を生み出した方々の思いに共感できること、ユーザーの立場や状況を想像できること、どちらも、おろそかにしないよう心がけています。

  2007/07/19

• マニュアルの図書館（下田）

  マニュアルの企画をするとき、類似製品とそのマニュアルの分析も、大事な要素になります。今は、マニュアルを自社サイトで公開している企業がたくさんあり、情報収集もしやすくなりましたが、さらに便利なサイトがこちら↓↓↓↓↓マニュアルネットこちらのサイトのテーマは、「マニュアルの印刷を削減することによる環境保護」ですが、テクニカルライターにとっての目玉は、本物の各種マニュアルが、大量に掲載されているところです。パソコン本体、周辺機器、携帯電話、情報家電など、様々な製品で、主なメーカーの製品が網羅されています。PDFファイルで、全ページをカラーで見ることができます。ひとつのカテゴリで各社見比べてみると、なかなか面白い。構成やデザイン、表現方法などのヒントも見つけられそうです。

  2007/07/12

• マニュアルの行方（白藤）

  異業種の方と話していると、物事の見方が違うので勉強になるなぁと思います。私は何かを学ぶには、紙に印刷された本を使うことが一番わかりやすいと思うのです。本は携帯ができるから、いつでもどこでも読めますから。どの部分を読んでいるかも、つかみやすい。けれども、違う業種の方は、e-Learning形式で、電子マニュアルが一般的になるのではないかと言うのです。その理由の一つには、紙の値段が上がっていること。いますぐに資材原価に影響がなくても、そのうちに影響があると予測できるから。新しい概念、新しい使い方の製品には、このように使うのですよというガイドが必要なので、「取扱説明書」「マニュアル」自体はなくならないと思います。ですが、取扱説明書の形態自体は変化するかもしれません。パソコンで説明書をじっくり読むにはどうしたらいいか。携帯電話での可読性はどうなのか...研究が必要ですね。その前に、技術についていけなくて、リタイアなどということのないように、勉強ですね。

  2007/07/04

全111件 (111件中 1-50件目)

1 2 3 >