出来の悪いマニュアルコンテスト

slashcow曰く、"毎日新聞の記事によると、技術文書作成・サポート会社の米テクニカル・スタンダーズ (TSI) が、「最も出来の悪いマニュアル」を選ぶコンテストを開催しているとのこと。ばかげた指示、スペルミス、文法間違い、誤訳などユーザーを悩ませるマニュアルを選ぶもので、今年で3回目となるイベントであります。現在はエントリー中だそうですので、応募してみるのも一興だと思います。ちなみに英語で書かれているのが条件となっております。"

日本語でよければノミネートさせたいマニュアルは、身の回りにごろごろしていそう。

ユニークな技術とマニュアルのできは反比例?

[sk (478)]

ちょっと名前は出せないが、某ASPのマニュアルを推したいところ。ここはGISに関係したあるサービスを提供していて、その分野では最高の技術なんだけど、マニュアルは最悪だ。個々の機能のインターフェイスだけは詳細に記述されているけど、全体での位置づけの説明がまったくない。たぶん技術者ばかりの会社で、開発者自身がマニュアルを書いているのだろう。

競合者がいないユニークな技術だけを売り物にしている小さな会社の場合、マニュアルにかけるお金も、その必要もないから、マニュアルの品質は悪くなる。逆に、マニュアルひどさは、それで会社がつぶれかけていないとしたら、技術のユニークさを表しているといってもいいかも。

日本独自の問題

[isi (4853)]

　日本でこの手のコンテストを開催すると、機械翻訳そのままのマニュアルも対象になるんでしょうね。

　少々前になりますが、Symantec社製品のマニュアルは何が書いてあるのかまったく理解できませんでした。
　単語だけを日本語に置き換えているだけだったので、素の英語より読みにくかった。
最近は改善されているようですが。

　その直後、他社製品のマニュアルを読んで「おお、日本語になってる！」と感動した覚えがあります。

Re:日本独自の問題

[Carol (2812)]

NetWare3.2のころのインストールマニュアルはひどいものでした。
「～を期待します。」ってインストールマニュアルで期待されてもなぁ。多分willを直訳したんだろうけど。

Re:日本独自の問題

[Anonymous Coward]

一時期（今も？）Symantec は幅広い製品ラインを抱えていましたから
翻訳資源が足りなかったんでしょうかね。

>他社製品のマニュアルを読んで「おお、日本語になってる！」
言語製品のことかしら？

ボーランドのマニュアルの品質が年々劣化し、今年は機械翻訳（もどき）に
戻ったことを考えると...

Re:日本独自の問題

[Anonymous Coward]

昔々、東芝エンジが出してた SUN の pixrect のマニュアルは凄かったなぁ。 機械翻訳に人間が手をいれて、なおさら意味が通じなくなってた。

Re:日本独自の問題

[goubu (3245)]

金をかけないからだめなだけです。 NEC、Sony、Omron、Zerox... どれも金をけちっているからちゃんとしたものができていません。

Re:日本独自の問題

[Sato_at_lilo (3250)]

> NEC、Sony、Omron、Zerox... どれも金をけちって
> いるからちゃんとしたものができていません。

NEC が直木賞作家の海老沢泰久氏を(監修者に) 起用して
マニュアルを作成した話 [google.co.jp]が一時期話題を
呼んだようですが、結局話題だけに終わったんだろうか。

# 金を(どれだけ)つぎこんだかは知らないけど。

Re:日本独自の問題

[nandabe (2412)]

うーん・・・ちゃんとしたものを作っても、ユーザーは読んで
くれないと言う事実が・・・・(^_^;)

＃パソコンの全ての操作を一枚の紙で、簡単に記せ！とメーカーに
　要求したオッサンがいたそうな。
　この場合「お前はパソコン使うな！」と書かれているのが正解
　でしょうか？(^_^;)

--
======= nandabe =======

Re:「機械翻訳」つながり(-1 オフトピック)

[L.Nizah (7804)]

「アセンブラ上等!!」 はカッコいい

我々は低レベルなプログラマです。
低レベルな事しか出来ません。
高レベルな話になると分かりません。

こんなのはどう?

[Anonymous Coward]

.ekil uoy sA

こんなのがマニュアルに書いてあったらどうします?

Re:こんなのはどう?

[oku (4610)]

どうしますって...取り敢えず /usr/share の下のマクロパッケージと照合しないと分かんないと思いますが。

# roff ですよね？

マニュアル通りに

[Anonymous Coward]

動かしても動かないのはマニュアルが悪いのかソフトに問題があるのか
#ソフトが悪いに決まっているけど

Re:マニュアル通りに

[gonta (11642)]

初めて3Dのソフトを利用するということで、そのソフト付属の
”いっしょに簡単なのを作って使い方覚えましょう”的マニュ
アルを読みながらチャレンジしたんだけど、そんな｛ダイアロ
グ・メニュー・ウインドウ｝ねぇよ！連発で、出来上がらなかっ
た記憶があります。

StrataProとかいったかな（安いほうで20000円くらいで買える
奴）。

どうやって使い方覚えろってんだよ・・

--
-- gonta --
"May Macintosh be with you"

別売

[shikine1 (8164)]

ソフトウェアのメディアとマニュアルは別売にしたら、少しは作る方でも向上させるように努力すると思います。

別売じゃなくても解説書が市販されていればそれでいいのですが。

Re:てゆうか

[Mr.Kato (10500)]

解説本が売れているということは、マニュアルに問題が
あることを証明しているような・・・

Re:てゆうか

[shikine1 (8164)]

解説本なら各社間の競争がありますから、そう簡単に出版できないということもあるでしょう。

Re:てゆうか

[Anonymous Coward]

あとコピー品が横行しているソフトね
(フォトショップとか)

Re:てゆうか

[u1p (2709)]

若いですね＞Photoshopが出てくる辺り

一太郎とナツメ社、とか言ってみるテスト。

Re:攻略本

[BNI (13271)]

…しかしながら、コンシューマ・ゲームのマニュアルなんてのは
ユーザに攻略本を買わせることを前提としているせいか
却ってどんどん質が落ちていっているような気がしてならないのですが。

＃ゲーム自体に含まれる情報量が多すぎて
　同梱できるサイズの紙媒体じゃ書ききれなくなってきた、
　というのならわからいではないのですが、
　その割には設定だのキャラ紹介だのに紙幅を割いていたりするし…

＃＃最近殊に酷いと思うのがこれ [srad.jp]関係。

--
We are the keepers of the sacred words "ni"!

Re:攻略本

[DrSaider (9448)]

ドラクエ世代のゲーマーはマニュアルなんて読まない人が
結構居るんじゃ？

かく言う私はマニュアル読まない派。
ゲームでもクリアー後に初めてマニュアル読んでみたりして

(ゲーム以外のマニュアルは当然インストール中に読みますよ！

残虐行為手当て

[Anonymous Coward]

テンゲンのマニュアル [susono.com]がノミネートできたらよかったのに…

Re:残虐行為手当て

[kalnov (4668)]

テンゲンはマニュアルの面白さもさることながら、ユーザーサポートも丁寧で好感の持てる会社でした。
アンケート葉書に「○○というソフトが欲しいけど近くで売ってない！！」
と書いたらメーカーから回答が来たのはここだけ。
しかも自社での直販以外に通販可能なショップを紹介して、
「ウチで買うよりここの方が安いですよ」と書かれてました。

マニュアルの充実度は会社の対応の良さと比例してるのでは・・・などと思ってみたり。

ちと違うんだけど

[gonta (11642)]

HPのマニュアルだっけかな？C言語のマクロ定義の説明で

円周率をPIとして
#define PI 3.14159265
としておけば、
”いざPIが3.14159265でなくなり変更が必要になったと
してもマクロ定義の個所を変えるだけで変更が終わる”

とあったらしい。円周率が変わることってあるのでしょ
うか？3.14159265を3.14にするとか桁増やすとかいう
話はなしよ・・・

--
-- gonta --
"May Macintosh be with you"

Re:ちと違うんだけど

[harupunte (10435)]

>3.14159265を3.14にするとか桁増やすとかいう
>話はなしよ・・・

なんで「なし」にするんだろう。
別にその例でも良いと思うんだけど。

Re:ちと違うんだけど

[wabix (3594)]

オフトピ。

小学校で使うプログラムであれば、
円周率は、「およそ３」 として教えられるので
変更の必要があります。

そういえば
円周率が 2 だったらいいのに、ってサイトがあったような。
URL 失念。
# 計算は楽になるんだけどね

Re:ちと違うんだけど

[tomatsu (2545)]

円周率が4だったらいいのに、ってサイトは見た事があります。
「３」はドコまで円周率か？（前編） [tripod.co.jp]、（後編） [tripod.co.jp]

Re:ちと違うんだけど

[wabix (3594)]

円周率が4だったらいいのに、ってサイトは見た事があります。

すみません。間違いました。そのサイトです。
2じゃなくて4だ。

# マイナスモデレートよろしく^^;;

Re:ちと違うんだけど

[tact (2632)]

大学入試の物理で頻出する 単振り子の周期 [cool.ne.jp] は 2π√(L/g) なので、π≒√g≒3.13 （g は重力加速度[m/s^2]）と覚えておくと計算が非常に楽になったりします。

Re:ちと違うんだけど

[shigezo (2455)]

＞円周率は、「およそ３」 として教えられるので

　亀レスで何なんだけど・・円周率=およそ３って本当に教えているの？？
　円周率３騒動 [justnet.ne.jp]

　上記を見る限りデマだと思うのですが？？

　重蔵。
　

高いソフトウェアほどひどいって感じがするかなぁ

[yuno (5162)]

やっぱり、コンシューマ向けじゃないと数が出ないからだと思いますけど、
サーバ用途みたいなモノって結構苦労させられた記憶があります。

自分の読解力が無いのか日本語が間違っているのか不安になっちゃいません？（笑）

そのほか、和訳モノは目次のページや、図表番号が原文のママだったりして
あっていなかったりもしょっちゅうしますよねぇ。。。

--
-- yuno

Re:高いソフトウェアほどひどいって感じがするかなぁ

[parsley (5772)]

タイトルの
＞高いソフトウェアほどひどいって感じがするかなぁ
になんとなく反応します。
使う側の期待値が大きいのが、原因の一つでしょうかね？
少数しか出ないものに対して、そんなにコスト掛けてられないよなんて作っている側は思っているかもしれません。 安くてかつたくさんの売れるものほど、広い範囲の人に分かるように書かねばならないでしょうし。(実行できているかどうかは別)

--
Copyright (c) 2001-2014 Parsley, All rights reserved.

Re:高いソフトウェアほどひどいって感じがするかなぁ

[Anonymous Coward]

最近はやっているアプリサーバ製品のマニュアルってどんなものでしょうか。

仕事でしかたなくinterstage使ってますが、これの
オンラインマニュアル(HTML)にひどく悩まされています。
職場の仲間も５人中５人が「わかりにくい」と愚痴をこぼす
状態。

スタートアップだけならXMLコンソーシアムのガイド [xmlconsortium.org]が各社製品に
対応している上、非常にわかりやすいです。
うちも助かりました。

プ→デ

[Anonymous Coward]

友人に見せてもらったマザボのマニュアルに
「デラクアンドデレイ」
とプが全部デに置き換わってるのがありましたね・・・

#知ってる人少なそうなのでAC

読まない人なの

[ta98 (10561)]

「私ってマニュアル読まない人なの」と言い放つ人、出くわしません？全部人に聞く、偶然操作してできたことを「発見」と言う、できないできないと何日も悩んでいるのに絶対マニュアルを読もうとしない。

そんな人たちはマニュアルは読む前から「出来が悪い」と思っているのだろうか？

Re:読まない人なの

[wakky (6757)]

>偶然操作してできたことを「発見」と言う
去年から、emacs(Meadow) をメインに使うようになったのですが、
「発見」がいくつかありました(^^;)

Re:読まない人なの

[johndoe (3028)]

読めない人の間違いかも

Re:読まない人なの

[masahikoi (1183)]

そういう人は、｢そのソフトに何ができるのか｣ がマニュアルを読まないと分からない、ということが分からないのでしょうね。多機能製品だと人間のほうが ｢何をさせればいいのか｣ わかりにくいわけで、そこが単機能製品 (単純な家電製品とか) と違うところなわけですが、そういうことが分かっていないから ｢マニュアルを読まなければいけないのが悪い｣ という発想になってしまうのでしょうね。

Re:読まない人なの

[kiyotan (3912)]

UNIX 系で思い通りのことができなくて、
「Windows ならできるのに」と言い放つ人種は
マニュアル読まない人達の部分集合だと密かに
思ってます。

--
Kiyotan

Re:読まない人なの

[9nu (12793)]

う～ん。必要があるものはマニュアルを読んで
作業をしますが、基本的には読まない人です。

個人的にはマニュアルを読まずに使える道具
が理想。
「ぱっと見で使えない道具は道具ではない」
という方針なので。

--
犬が犬であるように、猫でありたい

INT 19?

[g_maeda (6110)]

昔買ったどこかのSCSIボード、英語版マニュアルではINT 13hとなっているところを日本語版ではわざわざ十進数に直してINT 19なんて書いてあったので、一瞬なんのことかわかりませんでした。

# いらんことするな

あるだけマシ

[Anonymous Coward]

マニュアルがあるだけマシなんではないかと。

あるだけで迷惑

[Anonymous Coward]

Excelのマニュアルやヘルプ、Exchange Serverのマニュアル、見たことありますか？
「マニュアル作りました。言いたい事は書きました。」のレベルで困ります。
リファレンスにしようにも目的の記述に辿り着けない。ヘルプはキーワードで検索してもそのものズバリのページが出ることは稀。

解説書が出るのは必然です。

Re:たぶん

[Mr.Kato (10500)]

サポート料を取るために、サポセンに電話させるよう誘導しているのかも

Re:あるだけで迷惑

[Sato_at_lilo (3250)]

> Excelのヘルプ
に限定すると...

1. 重くて重くて、F1キー打鍵恐怖症になった程。
2. まず出て来る「文字をブルーにしたい」ナメとんのか。
3. 見たい情報は暗黒の底の五里霧の中の迷宮の奥。

じきに諦めました。辛うじて役に立ったのは関数リファレンス位だし。

Re:あるだけで迷惑

[L.Nizah (7804)]

1. 重くて重くて、F1キー打鍵恐怖症になった程。

知人のキーボード、F1キーがありませんでした。
壊れた/取れた のかと思ったら、他のキーボードも全部取っていた模様
うっかり触ってしまう人はキートップを取ると良いのかもしれません。

Re:あるだけで迷惑

[Sato_at_lilo (3250)]

> 知人のキーボード、F1キーがありませんでした。

「カスタマイズ」の理解されない職場でした...

# 本当はHHK [fujitsu.com]に 窓使いの憂鬱 [sourceforge.net]、
と逝きたかった

ある意味

[ta98 (10561)]

＞解説書が出るのは必然です。

ワークシェアリングを無意識に行っているのかも。不景気ですし。でもイルカは余計だなあ。知人に「イルカのアンインストールを教えてくれ」って何度も言われた。知らないと答えると（実際知らない、最初のインストール時にヘルプの類いをいっさいいれない設定にしないと無理では？）愚痴がいっぱい返ってきた。俺に言ってもねえ…。

使ってないのに迷惑こうむりました。

Re:ある意味

[Sato_at_lilo (3250)]

> 知人に「イルカのアンインストールを教えてくれ」って
> 何度も言われた。

同僚には、「冴子先生」萌え萌えな香具師もおりました。

# 僕はうざいので引っ込めてましたが。

VIRTUAL PC for Windows

[Anonymous Coward]

逝ってよしな感じ。アスキー系のしか知りませんが、メディアビジョン系のほうは違うんですかね？

Re:これもチトちがうのだが

[gonta (11642)]

NICのドライバがネット上にある。
CD/DVD-ROMのドライバがCD-ROMで提供されている。
フロッピーのドライバがフロッピーで配布されている。

などと同様の現象でしょうね。

--
-- gonta --
"May Macintosh be with you"