マニュアル執筆が怖くなくなる、12の執筆ポイント
前回「『目次』の良し悪しが、すべてのマニュアルの良し悪しを決める」に引き続き、分かりやすいユーザーマニュアルの作成ポイントを説明します。前回は「構成」について説明しました。今回は「表現方法」についてです。 「操作マニュアル」「業務マニュアル」「障害対応マニュアル」 について、全部で12のポイントを解説します。 操作マニュアルを記述する 1．読み手に分かりやすい流れを考える ユーザーが操作マニュアルから知りたいことは「操作手順」と「操作の結果」です。 操作マニュアルでは、これらの情報を、「画面のイメージ」と「説明文」の組み合わせで表現します。 ＋ 操作の結果 操作の結果を表示する画面 処理内容や操作結果を説明する文章 ただし、一般的にシステムの操作は、次のような流れになります。 表示されている画面で操作を行う ↓ 結果の画面に遷移し、新たな画面が表示される≫ ↓ 表示されている画面で次の操作
スタートアップ企業で8年間Webの開発をしてみての反省点いろいろ - Masatomo Nakano Blog
2002年、当時設立したばかりの会社に入り、何もない状態から、コンテンツとシステムを作り続け8年が経った。日々、試行錯誤しながら、それなりに会社も大きくなり、まだ、大成功とは言えないけど、それなりにうまくやってきたつもりだ。 しかしながら、その8年という短くはない時間の中で、色々な課題や問題が発生し、その時々正しい選択をしてきたつもりだったけど、反省点も多い。もう一度スタートアップに参加するとしたら、やり直したいところや、もっと早くこうしていれば良かったというところがたくさんある。 そんなわけで、次の挑戦のときに忘れないように、また、もしかして誰かの参考くらいになればと思い、メモっておくことにした。1 まず、反省点の前に、何をやっているのかというのを簡単に。 ビジネスとしては、英語e-learningのWebサービス(ネットを使った英語のお勉強)をASPな形で、企業や大学などに提供している
ウノウラボ Unoh Labs: DBの選択について
皆様、はじめまして。 7月入社のトクヤマと申します。 以後、お見知りおき頂ければ幸いです。 私は以前、別の会社の仕事でPostgreSQL,MySQL,Oracle,SQLSeverを同時に運用していたことがありました。 また現在はMySQLとPostgreSQLを運用しています。 今回はそれぞれのDBを、どのようなWEBサイトやオープン系の開発を行う時に選ぶべきなのかという事をお話したいと思います。 なおOracle、SQLServerは現在はWEBサイトやオープン系の開発では使われなくなっていますのでPostgreSQLとMySQLに絞りたいと思います。 「定説」として以前はPostreSQLは多機能で遅い、MySQLは機能は少ないが検索が速いと言われていました。 しかし、それぞれバージョンアップを繰り返すうちに現在は、どちらもお互いの特徴をカバーしてきています。 それではどの
お客様を知るためのマニュアル作成 - （旧姓）タケルンバ卿日記避難所
マニュアルを書くのはオススメ。プログラムの世界以外でもかなり有用だよ。 設計書よりもユーザーマニュアルを書こう！ - レベルエンター山本大のブログ 設計書に書かれた処理の手順なんてのを読んでも機能についてピンとこないが、 ユーザーマニュアルなら分かる。 なぜなら、分かるように書かなくてはならないからだ。 分かりやすくなくては、マニュアルの存在意義に関わる。 設計書よりもユーザーマニュアルを書こう！ - レベルエンター山本大のブログ こういう要素があるからこそ、書き手にとっていいトレーニングになるんですよ。取り組んでいることへの理解が進むし、ポイントの整理ができる。そして顧客の要望とか、需要なんかをつかみやすくなると思うんですよね。 読む人はプロではない 基本的にですよ、マニュアルというのは説明書なわけですよ。単純に考えてね。でだ、説明書が必要な人ってのは、使い方がわからないわけですな。知識
mixiや楽天の「中の人」、インフラエンジニアを語る
パソナテックは2008年12月6日、「インフラエンジニア討論会2008 ～インフラエンジニア進化論～」を開催した。楽天の和田修一氏、スカイホビットの越川康則氏、ミクシィの長野雅広氏、モトローラの石原篤氏、paperboy&co.の宮下剛輔氏、計5人の「インフラエンジニア（サーバやネットワークなどの設計・管理・運用を担当する技術者全般を指す）」が登壇し、自らの業務や興味関心、インフラエンジニアとして働くことのやりがいなどを語った。 個人のスキルに「依存した」運用の可能性 前半は各自のトークセッションとして、自らの業務、キャリア、興味関心などを5人がそれぞれ講演した。 和田氏は現在「開発部 国際開発室」に所属しており、アプリケーション開発も若干行っているものの、メインは台湾版「楽天市場」の設計・構築・運用の業務を行っている。大学時代は経済学部で、技術を学んだのは就職後。「大学時代はバンドに明け
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
ちょっとした構成案を作れば、あなたのドキュメントはもっとわかりやすくなる！
http://japan.internet.com/busnews/20080521/8.html
