インターフェイスとインターモルディアの違い：ソフトウェア製品の文書化とローカライズへのアプローチ

かつて、 Parallels Desktopの技術文書では、「 仮想マシンのハードディスク 」というフレーズを使用する必要がありました。 英語では、 仮想マシンのハードディスクのように聞こえます。 過去のテクニカルライターは、1単語の1文字だけを間違えましたが、意味は正反対です。 これはすぐには気づかず、ある時点で、世界の多くの言語にローカライズされたテクニカルドキュメントには、不変の仮想マシンハードディックが含まれていました 。 大きなスキャンダルがあり、その後、テキストの検証を強化しました。 テクニカルライターのAndrei Starovoitovが、テクニカルライターが住んでいる場所、キャッチする対象、 Parallelsが製品を文書化およびローカライズする方法について説明しています。



おそらく質問があります-開発者/プログラマー/テスターである私が、ドキュメントとインターフェースがどのように作成されローカライズされるかを知る必要があるのはなぜですか？ すべてが非常に単純です。人生は突然あなたに向かえるので、今日あなたはプログラマーであり、明日はあなたがスイス人、刈り取り家、そしてテクニカルライターであるスタートアップを始めます。 また、管理職に就くと、突然技術文書の開発プロセスを管理しなければならない可能性もあります。

パート1：技術の裏でテクニカルライターまたは人道主義者を見つける場所

テクニカルライターは大学で訓練されていません。 このような専門家が必要な場合は、海外から招待するか、会社で「成長」させることができます。 以下に、これらのオプションについて詳しく説明します。

外国人専門家

長所 ：

製品を海外で販売する予定で、英語の文書が必要な場合は、ネイティブスピーカーがアプリケーションをより良い品質で説明します。 これは、言語に精通した国内の従業員が必ずしも悪いことをするわけではありませんが、完璧主義の観点から問題に取り組むと、一部のフレーズ、売上高、および文章の構築について、外国人ユーザーはドキュメントがネイティブスピーカーによって書かれていないことを理解できます。



短所 ：

まず、外国の専門家はより多くの費用を支払う必要があります。 そして第二に、すべての外国人がロシアで働くことに同意するわけではありません。 彼が開発者から隔離されてリモートで作業する場合、ドキュメントの準備のタイミングが遅れ、技術的に不正確になる可能性があります。なぜなら、プログラマーと直接話をするよりもリモートで技術的な詳細を見つけることは常に難しいからです。

「成長した」作家

ここで、技術者または人文科学のどちらから成長するのかという疑問が生じます。 もちろん、すべては特定の状況に依存しますが、主なポイントを見てみましょう。



「技術者」

長所 ：

技術者はスタッフィングと技術的な詳細をよりよく理解しているのか、それとも彼が理解しやすいのか。



短所 ：

開発者はしばしば狭い領域に焦点を当てており、「目利きの科学的な外観ですべてに少し触れることができる」エフゲニー・オネーギンではなく、自分を彫刻家と見なしているため、すべての技術者がドキュメントに煩わされるとは限りません。



「人文科学」

長所 ：

それはすべて特定のケースに依存しますが、人文科学はより良い言語を話すので、製品をよりよく説明できます。 しかし、そのような瞬間でも、開発者は機能や機能を2つの文で説明できます。知識の蓄積で、すべてをすでに理解しているからです。 製品の購入者にとって、そのような説明では不十分な場合があります。 人文科学では、素人として、さまざまな疑問が記述に生じます。 彼がそれらへの答えを見つけて、彼自身が理解するような方法で製品機能を説明すれば、そのようなドキュメントはユーザーにとってより理解しやすくなります。 繰り返しますが、それはすべて特定の状況に依存しますが、マニュアルが管理者向けに書かれている場合、IPアドレスとは何かを説明する必要はありません。



短所 ：

人文科学の欠点は、製品の技術的な側面についてあまり知識がなく、用語を習得し、基本を学び、内容を理解し始めるのに時間がかかることです。



個人的な経験

-私は非常に普遍的にParallelsになりました。 放課後、彼はセルプホフ市の教師養成大学で英語教師として学びました。 モスクワ州立言語大学で。 モーリス・ソレス。 大学3年目に深刻な仕事の問題が生じたとき、私はすでにDVD配布の宅配便業者、倉庫担当者、倉庫管理者、販売管理者になりました。 これはすべて良かったが、英語で生計を立てたいという欲求は強かった。 石油産業やITなどの応用分野で働きたいと思ったので、私は教育には行きませんでした。



求人検索サイトの1つで、キャリアを伸ばす可能性のあるSWsoftのアシスタントテクニカルライターである空席を見つけました。 この発表では、コンピュータープログラムのドキュメント作成への参加について話しました。 英語ですぐに文書を書く必要がありました。 私にとっては、まったく新しくて面白いものでした。 私は履歴書を送り、インタビューを受け、自由なトピックに関するエッセイを書いたので、ジュニアテクニカルライターになりました。



最初は簡単ではありませんでした。 骨の髄のヒューマニストであるため、最初のトピックを書くとき、周りの人はなんらかの鳥の言葉を話しているようでした。 私は完全に用語を知りませんでした。 開発者との最初の会話は次のようなものでした ：



-こんにちは、私は新しいテクニカルライターです。 この機能について説明する必要があります。 仕組みを詳しく教えてください。

-さて、ここではすべてが単純です。クライアントは「接続」します。「サーバー」が死んでいない場合は、すべてが正常です。 どちらかといえば、「ping」できます。 「バグシューティング」、「コンテナがぶら下がっています」がありますが、ここでは「パッチ」をロールバックできます。 この「実行可能」なものは、テスターの間の「カブ」にあります。 わかった？ よくできました。



または：



-ここで機能を説明する必要があります。それはActive Directoryに関連付けられています。 それが何であるか教えてもらえますか？

-はい、これはLinuxのLDAPと同じです。



最初にこれらすべての用語をノートに書き留めてから、その意味を「グーグル」で調べました。 その後、私は再び開発者またはテスターに​​行き、新しい方法で尋ねました。 最初の6か月間は、仕事と勉強の暇な時間に用語を勉強し、自動化、仮想化、コンテナ、仮想マシン、RAM、プロセッサ、IPアドレス、DHCPなどの内容を読みました。この領域でより自由に感じ始めました。 私が何かを理解していなかった場合、Googleは主なアイデアを把握するのに十分であり、主に詳細のために開発者に行きました。



現在、私は約8年間会社で働いています。 彼はシニアテクニカルライターに育ちました。 現在、ドキュメントとインターフェイスを作成するだけでなく、サポートされている言語に翻訳しています。

パート2：技術文書の作成方法

3人がドキュメントの作成に取り組んでいます。ロシアに2人、アメリカに1人、英語が母国です。 テクニカルブックを作成するには、 AuthorIT製品を使用します。 で作業することは非常に便利です。 書籍のあるライブラリはサーバー上にあります。 各ライターは、ライブラリに接続するコンピューター上にクライアント部分を持っています。 これにより、複数の作家が1つの本で作業できます。 オプションを使用すると、古いバージョンに基づいて新しいバージョンの製品のブックを簡単に作成できます。







歴史的に、私たちはAuthorITで働いているので、ドキュメントを作成できる他の製品について何かを言うのは難しいです。 彼はこれまでのところ私たちに満足しており、好奇心だけから別の製品に切り替えることは高価な喜びになることがあります。 たとえば、同じAuthorITサブスクリプションを3人で使用すると、月額375ドル以上かかります。



当社の主な販売市場は海外にあるため、すぐに英語で文書を作成します。 現在、英語は世界の共通言語と見なされているため、英語のドキュメントに問題がないことを確認するために特別な注意を払う必要があります。 もちろん、ロシア語で書いてから英語に翻訳することもできますが、これにより、翻訳がどの程度うまく行われているかを確認する必要があります。



すぐに英語で書く機会があり、同時にこの英語が理解可能であり、テキストがネイティブスピーカーによって書かれたように見えることを確認する機会があるため、これにリソースを費やしたくありません。



ドキュメントの作成プロセスは次のように構成されています。



1）マネージャーとのマーケティングでは、製品の新バージョンで導入される機能と改善点のリストについて議論します。



2）各タスクについて、マネージャーは詳細な説明を書き込みます。



3）プログラマーが機能を実装した後、最新バージョンのプログラムをコンピューターに配置し、説明を読み、新製品の仕組みを試し、マニュアルで説明します。 ご質問がある場合は、マネージャーまたは開発者と連絡を取ります。



4）新しい機能を英語で説明し、確認のためにトピックを外国のライターに送信します。 彼は読み、必要であれば変更を加えます。 私は英語をよく知っているようですが、それでもネイティブスピーカーはより簡潔かつ簡潔に自分自身を表現できることがあります。



5）チェックした後、外国の作家がトピックを送信し、データベースにアップロードし、必要な形式でドキュメントを公開します-基本的にこれはコンテキストヘルプ用のPDFおよびXHTMLです（これは、画面に疑問符が付いたアイコンをクリックすると、この画面に添付されたヘルプトピックが開きますブラウザで）。



6）英語のドキュメントの準備ができたら、翻訳のために送ります。 どの言語でどの言語で翻訳するかについて、以下で説明します。







製品用に作成されるドキュメント：



ユーザーガイドは、製品の最大の本であり、すべての機能、トリック、および考えられる問題の解決策について説明しています。 ほとんどのユーザーを対象としています。



入門ガイドは、インストール手順と製品の使用を開始するために必要な基本手順を説明する短いドキュメントです。 製品と、ある程度の経験があり、追加の設定や微妙さを紹介せずにアプリケーションの操作をすぐに開始したいユーザーを知ることに焦点を当てています。



Readmeは通常、リリース、ホットフィックス、およびアップデートごとに作成されるテキストファイルです。 何が行われ、何が改善され、どの問題が解決されたかを説明します。



ナレッジベースの記事は、いわゆるナレッジベースの記事です。 ユーザーから頻繁に質問されるいくつかのポイント、または既知の問題に対する一時的な解決策について説明します。



他にもさまざまな種類の本があります。



- ライセンスガイド （アカウントの作成方法、キーまたはサブスクリプションの管理方法など）

- 管理者ガイド （大企業で製品を展開するための技術経験のある人向けのドキュメント）

- トレーニングマニュアル （製品の使用方法をユーザーに教えるためのドキュメント）

- コマンドリファレンスガイド （テキスト文字列のコマンドについて説明し、アプリケーションの例を示します）

-APIリファレンスガイド （そのような本では、APIが文書化されています）。



ドキュメントを作成するために使用するツール：



-AuthorIT-書籍を作成して作業するためのプログラム。

-Adobe Photoshop-ドキュメンテーション用のスクリーンショットを作成および操作します。

-Microsoft Visio-スキームを作成します。

-Microsoft WordおよびAdobe Acrobat -.docx形式でドキュメントを発行し、その後PDFで生成します。



ドキュメントの作成作業にはさまざまな奇妙な点があります。 主に作家の不注意に関連するか、何かが急いで行われ、さりげなく見逃されている場合。 たとえば、「Vasyaでこのゴミがどのように機能するかを検証する」など、作家のコメントが削除されていない既製のドキュメントが発行された場合がありました。



また、作家自身が内部使用のためにドキュメンテーションをからかっていることも起こります。 一部の人々は、誰もそれを読んでいないので、誰もドキュメントを必要としないと信じています。 ある会社の非公式文書のライターは、「最初にこれを読んで、私に電話する人はビールを獲得する」という指示のテキストを書くことがあります。

パート3：テクニカルライターがGUIの作成に貢献する方法

機能の作業中に、開発者は多くの場合、オプション名、メニュー、オプションの下の説明、またはエラーメッセージを考え出す必要があります。 すぐに英語でguiを作成するため、開発者はこのタスクを私に任せています。 機能の説明を読み、開発者と管理者に何を言う必要があるかを尋ね、詳細を調べ、英語版を提供します。 彼が技術的に正しい場合、私は外国の作家に承認のためにそれを送り、開発者から見つけたすべての詳細を彼に知らせます。 彼は、私のオプションを承認するか、彼自身の何かを提供します。 最終バージョンがすべての人に適している場合は、注がれます。



guaを作成するプロセスでは、次の点を順守します。



1）翻訳が適合しない場合のローカライズに関するその後の問題を回避するために、オプションの名前をわかりやすく短くするようにする必要があります。 たとえば、仮想マシンウィンドウの境界でマウスカーソルを遅くするオプションがあります。 これは、Windows 8のユーザーが境界線の近くにある追加メニューをより簡単に開くことができるようにするために行われました。 このオプションがなければ、ユーザーはしばしばカーソルを海外に移動しただけで、国境を越えたメニューは表示されませんでした。 そのため、このオプションを何と呼ぶべきか長い間考えていましたが、長すぎるか完全に明確ではないことが判明しました。 その結果、「ウィンドウの端にマウスを刺す」ことに決めました。 もちろん、オプションの理想的な名前を思い付くのが難しい場合があります。そのような状況では、多かれ少なかれ受け入れられるオプションを選択し、ユーザーが理解できない場合はドキュメントを読んでください。



2）メッセージが複雑な用語を使用している場合や、問題の解決方法の時間のかかるプロセスを説明している場合、KB記事またはより詳細で詳細な説明または説明がある他のリソースへのリンクを提供することは理にかなっています。



3）メッセージを作成するとき、うまくいかなかったという事実ではなく、目的の結果を達成するために何をする必要があるかに集中する必要があります。

パート4：技術文書とGUIの翻訳

プログラムの新しいバージョンの開発が開始された後、通常、ローカライズに送信できるヘルプトピックとGUIフレーズの最初のバッチはBeta 1 / Beta 2によって蓄積されます。



私の意見では、トピックを書いて、その男を作るのを手伝った作家が翻訳を管理し、翻訳事務所と連絡をとるのはとてもクールです。 そのような人は有能に仕事を計画し、いつ書かれるのか、何かを説明するのにどれくらい早く必要かを知っています。 彼はフレーズの意味を知っており、翻訳者の質問にもっと簡単かつ迅速に答えることができます。



以前は分離を使用していたことを覚えています-書く人がいて、ローカライズのみを扱う人がいます。 その結果、プロセスは必ずしも効果的ではありませんでした。 たとえば、ライターは機能を説明し、Jiraでのタスクは終了し、落ち着きました。 しかし、変更されたすべてのトピックに注意するのを忘れていました。 その結果、ローカライズマネージャーは翻訳のためにすべてを送信しませんでした。その結果、急いで行方不明者を翻訳する必要がありました。 または、ローカライズマネージャーが翻訳を翻訳に送信しましたが、翻訳を作成しなかったため、翻訳者の多くの質問に答えることができませんでした。 GUIの一部はTimサーバーによって作成され、一部はデバイスによって、一部はギッシャーによって、一部はインテグレーターによって、短時間の損失で詳細な回答ではなく、結果として不十分な翻訳品質で作成されたため、さまざまな人々を引き付け始めます。



製品のドキュメントとGUIを次の12言語に翻訳します：ドイツ語、フランス語、イタリア語、スペイン語、ポーランド語、チェコ語、ロシア語、ポルトガル語（ブラジル）、日本語、韓国語、簡体字中国語と伝統的な台湾語の2つのバージョン。



その後、疑問が生じる場合があります-あなた自身の翻訳者を持つか、翻訳会社のサービスを使用するのが最善か。 両方のオプションの長所と短所を見てみましょう。

自分の翻訳者

長所 ：

州に翻訳者がいる場合、彼らは通常製品をよく知っているので、より良い翻訳をすることができます。



短所 ：

原則として、多くの翻訳を行う必要がある製品開発の最もアクティブな段階は3〜4か月続きます。 このような状況では、すべてを考慮する必要があります。なぜなら、翻訳者を継続的に維持することは経済的に採算が取れない可能性があるからです。

翻訳事務所

長所 ：

開発が本格化したときにタスクを送信し、これらのタスクの完了に対してのみ支払います。 その結果、これはスタッフに12人の翻訳者がいるよりも安いです。



短所 ：

多くの場合、翻訳オフィスはあなただけでなく、1人の翻訳者が今日の注文に対応できますが、明日は完全に異なります。 あなたの製品についての彼は、まったく考えがつかないかもしれません。 翻訳の質を落とさないために、翻訳者に多くの説明を書かなければならないので、翻訳者は何を翻訳しているのか、何に注意を払うべきなのかを知ることができます。



欧州企業のいずれかのサービスを使用しています。 彼女にはさまざまな言語の翻訳者がいます。



すべてのテキスト資料は請負業者に送信されます。 形式は大きく異なる場合があります。



•GUIローカライズ中-.txtファイル、.stringsファイル、.xmlファイル、.xliffファイル、

•ドキュメントをローカライズする場合-.docxファイル、.xmlファイル



まず、GUIをローカライズする必要があります。 翻訳フーフの各部分について、翻訳者のために詳細なコメントを準備します-各フレーズに対して。 コメントでは、それがどのような種類のフレーズであるか、どのように翻訳するかを説明します-不定詞または命令詞、可能な限り短く翻訳する必要があるかどうか（特にボタンの場合）、そうである場合は、何人の文字を収めるべきかを説明します。 また、オプションやメッセージがグアでどのように見えるかを確認できるように、翻訳者にスクリーンショットを送信します。

最初にすべきことはGuiの翻訳である理由

実際、翻訳されたフレーズは、いわゆる翻訳メモリ-翻訳メモリに分類されます。 この記憶から、翻訳のためのフレーズの後続の部分で正確に同じであることが判明した場合、それらはその後取得されます。 たとえば、GUIを翻訳し、オプションの長さを決定しました。 その後、これらのオプションが説明されている翻訳用のドキュメントを送信します。 したがって、ドキュメントのこれらのオプションの翻訳は翻訳メモリから取得されるため、GUIとドキュメントの両方のフレーズは同じ方法で翻訳されます。 最初にドキュメントを翻訳し、次にguiを翻訳した場合、オプションがguiで長すぎる場合は、GUIとドキュメントの両方を編集して、どこでも一貫性が保たれるようにします。これは余分なことです。



翻訳者の準備が整い次第、翻訳された資料を送って、データベースにインポートします。そこからローカライズされた人とドキュメントがビルドに入ります。

翻訳会社はどのように機能しますか？

私たちから資料を受け取った請負業者は、完成した翻訳のデータベース、いわゆる翻訳メモリを介してそれらを実行します。 システムは、一度翻訳された新しい資料にデータがあるかどうかを探します。 これらの完成したフラグメントがテキストに挿入されるとわかります。 送信された4つの段落のうち3つが前のリリース用に既に翻訳されている場合、4番目の段落のみを翻訳し、残りはデータベースを取るだけで十分だと仮定します。 これにより、時間とお金の両方が節約されます。 したがって、材料の最初の部分は最も長く翻訳され、ほとんどの変更と新しいテキストが含まれます。



ローカライズ企業と協力することには1つの特徴があります。彼らは一度にできるだけ多くの資料を送信する必要があります。 注文が少なすぎる場合、これははるかに高価になる可能性があります。

なぜこれが起こっているのですか？

各ローカライズ会社には、独自の最小転送量があります。 データベースを実行した後、翻訳するテキストが少なすぎることが判明した場合、翻訳された単語に対してではなく、翻訳者の1時間ごとの請求書が発行されます。 また、リリース日が近づいているため、ローカライズが必要なテキストの部分が小さくなっているため、過剰な支払いをせずに蓄積するために資料を保持して操作する必要があります。 同時に、リリースの1週間前に大量の転送オーダーを展開して、期限を守らないことが重要です。

ローカリゼーションのコスト

おそらく、製品のローカライズに企業が費やす金額に興味がありますか？ 選択したサイズと言語に大きく依存します。 たとえば、1つの単語をポーランド語に翻訳するコストは0.14ドル、ドイツ語に-0.23ドル、フランス語に-0.21ドルです。 大規模で複雑な製品があり、12の言語に翻訳する必要がある重いドキュメントがあります。 したがって、ローカリゼーションの総コストは平均10〜60千ドルです。さらに、これには、さまざまな作業方法を説明するナレッジベース（ナレッジベース）からの記事の翻訳コスト、およびサイトでの変更のローカライズは含まれません。

「紳士は言葉を」

言語の多様性と高い作業コストを考慮して、翻訳の品質をどのように評価できますか？ 請負業者が単にGoogle翻訳を介してテキストを実行し、結果が調整された場合はどうなりますか？



実際、ローカリゼーションの分野では、評判が非常に重要です。 企業がドキュメントとインターフェイスを翻訳する請負業者を探しているとき、彼らはこれに非常に慎重にアプローチします。 たとえば、約15社から選択しました。テストの課題を全員に送信し、これらの言語を理解しているさまざまな国の従業員に対して行った翻訳を確認しました。 また、実行された作業に関するレポートにも細心の注意を払いました。詳細度、翻訳された単語数、新しい単語が見つかった数、文の一部のみを翻訳する必要がある場合などです。



最終的に、私たちは請負業者として会社の1つを選択し、それを使い始めました。 しかし、これは私たちがそれ以来彼らの言葉を受け入れたことを意味しません。 翻訳の品質は定期的にチェックされます：



•関連する言語を理解する従業員、

•請負業者の翻訳者。 実際のところ、一部はそこで翻訳されますが、他の人はリクエストに応じて読みます。



確かに、ある会社の仕事を別の会社の専門家と確認する必要があると言うでしょう。 しかし、実際のところ、ローカライズ会社は顧客のために必死に戦っています。 そして、私たちが誰かにテキストを送って評価するように頼むと、彼らはすぐにそれがひどく翻訳されたと私たちに告げるでしょう、私たちはもっと良くしましょう。 実際、私たちを誘惑しようとする試みは今のところ止まりません。



大きなリリースが発表されたときに、期限の少し前にローカライズされたドキュメントを常にチェックできるとは限りません。 それから、あなた自身の危険とリスクをそのままにしてそれをリリースしなければなりません。 しかし、そのような場合、私たちはサポートと密接に連携します。ドキュメントにユーザーから苦情が寄せられている学校があれば、すぐに翻訳者に頼ってやり直します。 幸いなことに、これはめったに起こりません。

翻訳の問題

翻訳作業の過程で、特定の妨害が発生する場合があります。 それらはすべて、翻訳事務所と慎重に話し合い、それを整理し、これが二度と起こらないようにする必要があります。



1）不注意な翻訳者 -フレーズのフレーズに変数がある場合、不注意な翻訳者はその一部をスキップすることがあります。 たとえば、変数（％1）があり、転送では（％1）を取得します。 その結果、フレーズは本来の形になりません。



2） 翻訳者はそれについて考えました -私たちは皆人間であり、翻訳者が間違ったものを翻訳することがあります。 たとえば、「このファイルは無効です」というフレーズは、「ファイルが見つかりません」と翻訳されます。



3） 翻訳者を徹底しすぎる -そのような翻訳者は、彼が見るすべてを翻訳します。 ここでは、ProductName変数を「製品名」として変換する必要があることを説明する必要があります。そうしないと、変数が壊れて、GUIで製品名が置換されません。 または、ドキュメントとともに.xmlファイルを翻訳する場合、タグを翻訳する必要はありません。翻訳しない場合、タグが壊れているため、そのようなxmlはデータベースにインポートされません。



4） 難しい技術用語または略語 -翻訳のテキストに類似したものがある場合は、すぐにコメントで翻訳者の注意を引き、それが何であるかを説明し、それがどのように彼らの言語に正しく翻訳されるかを見つけるようにグーグルに助言することをお勧めします。 それ以外の場合は、目的の用語から遠く離れたものを取得できます。



5） コメント不足によるショール -翻訳者にコメントをしないと、すべてのあいまいな点について質問をすることができません。 その結果、翻訳の品質が低下する可能性があります。 , Parallels Access, iOS Android . , . Access . , , «», «».



6) – , . – . . , . . , Unable to save the license file. , , - Parallels Desktop. – « Parallels Desktop.» , « », .



7) – , , – . – , , «...», .



8) – , – 3 , . – , . – 3-4 .



9) – . , – , . - , – , , . .



10) – – . — . . , - , . . , . , Ctrl+Alt+Delete. , . , — Delete. , , , Ctrl+Alt+Delete Delete, : Delete, Ctrl+Alt+< >. , Delete . Ctrl+Alt+. . 別の例。 Parallels Access, “Welcome to Parallels Access”. , . , : Welcome, to Parallels Access. . , , . , . « Parallels Access» «Parallels Access ». .



11) – - , . , « - ». – “Your grace period expires in %1 days.” , . , – « 5 /3 /1 ». ( , , – «.», – «.», – «.») ( “Days left until the grace period expires: %1.”. - , , (, (5), (3) , (1)), , .

, - , .

– , , . , .

:

, . , , , . , , , 12 .



:

. , , . , . , , , - , 12 – .

:

. , , . , , . , .



:

. , , 12. .



, , , – . -. , , , . , . .



.. !