テクニカルライターの日常生活:CISからStrugatskyまで

ソフトウェアを開発する会社では、ドキュメントの管理と異なる言語への翻訳に関連するタスクが常に多くあります(特に会社が国際的な場合)。 私たちの場合、これらの問題は両方とも関連しており、タスクのフローは非常に重要であるため、技術文書部門には大きな負荷がかかっています。



Positive Technologiesのテクニカルライターは、純粋に技術的な(製品、企業、業界標準の付属文書)から、Strugatskyをほのめかした非常に芸術的な反論まで、社内で生まれたすべてのテキストに手を出します(PHDays 2012のCTF大会の伝説を参照)。 このような多様なタスクのタイミングと品質をどのように制御するかについて知りたい場合は、catを歓迎します。



まず、テキストとタスクの種類に関する作業の方向性を想像してみましょう。





次に、各アイテムを個別に分析します。



知識ベースプロセス



XSpiderセキュリティスキャナーの知識ベースとMaxPatrolセキュリティおよびコンプライアンス分析システムの関連性を開発および維持することは重要なタスクです。



この場合の手順は次のとおりです。会社の専門家が脆弱性を発見し、ソフトウェアシステムでサポートを実装した後、新しいタスクに関する通知が技術文書部門に送信されます。ロシア語と英語で脆弱性の説明を作成する必要があります タスクは特定の従業員に割り当てられ、実行(説明または翻訳の作成)され、必要なリンク、CVCコードがテキストに追加され、データベースにコミットされます。



ドキュメント



タスクのもう1つのクラスは、会社の製品(XSpider、MaxPatrol、SurfPatrol)のドキュメントの作成です。たとえば、いくつかの「ユーザーガイド」と「管理者ガイド」を改善するための作業が継続的に行われています。



標準を使用する



3種類の標準を処理する必要があります。



国際標準は、国際機関(CIS)またはソフトウェアおよび機器のメーカーによって開発され、一般に情報セキュリティの分野で認識されています。



このようなドキュメントが登場した後、テクニカルライターの仕事は、高品質で関連性の高いロシア語への翻訳です。 翻訳プロセスでは、さまざまな詳細を明確にするために、常に研究センターの専門家と連絡を取る必要があります。



特定のソフトウェアまたはデバイスの標準が実際には存在しない場合があります。 これは頻繁に発生し、そのような場合、Positive Researchの専門家が独自の設計の標準を作成します。 この場合の技術文書部門のタスクは2つに分けられます。まず、標準のテキストを「専門家」言語からロシア語に翻訳する必要があります:)次に、すでに適合したバージョンを英語に翻訳する必要があります。



その後、ドキュメントのテキストがソフトウェアまたはハードウェアの製造元に送信され、Positive Technologies製品のナレッジベースに追加されます。 その後、規格は広く普及し、国際的になりました。



翻訳



翻訳についておもしろいことがわかると思いますか? テキストを取り、翻訳してください。 ただし、タスクのフローは非常に大きいため、すべてのルーチン操作を自動化する必要があります。 翻訳の場合、ルーチンは同じタイプのテキストの翻訳であり、同じ用語と概念が多数見られます。 2人の翻訳者が同じ用語を異なる方法で翻訳できますが、情報セキュリティの分野ではこれは容認できず、曖昧な定義の場所はありません。 したがって、誰かが用語を1回翻訳し、翻訳が承認された場合、将来、この概念がテキストで見つかると、既製の翻訳バージョンを使用する必要があります。 特別な翻訳支援システム( Trados )がこの問題の解決に役立ちます。







ソースコードがシステムにロードされ、翻訳者は別のウィンドウで作業を開始します。 翻訳されたテキストのいわゆるメモリの原則が作用します。Tradosはフラグメントまたは単一の単語を記憶するため、将来、他のテキストで類似の単語またはフラグメントが見つかった場合、翻訳オプションが表示されます。 これは、翻訳の統一を真剣に助けます。



PHDaysの翻訳



ご存知のように、Positive Technologiesは、情報セキュリティに関するPositive Hack Days国際フォーラムの主催者です。 このフォーラムは国際的なものであるため、世界中からかなりの量の外国人訪問者を受け入れています。 CTFバトルに参加しているスピーカー、チーム、独立した研究者がいます。 技術文書部門のタスクの1つは、PHDaysフォーラムに同行することです。



この作業は簡単なものではありません。紙上のテキストの翻訳と音声の連続した翻訳は、オデッサで言われているように、2つの大きな違いです。 しかし、2年目はすべてがバタンと消えました:)



もちろん、記者会見とマスタークラスを翻訳し、フォーラム自体で進行役を支援することは、氷山の一角にすぎません。 PHDaysの膨大な数のブックレット、記事、ブログエントリも、テクニカルライターや翻訳者の思いやりのある手に渡ります。



科学記事およびマーケティング資料



リサーチセンターポジティブリサーチでは、さまざまなベンダーのソフトウェアの新しい脆弱性を検出する作業が昼夜を問わず行われています。 Responsible Disclosureの原則に従って、発見された脆弱性をソフトウェアメーカーに通知し、脆弱性がパッチによって閉じられた後にのみ、詳細な説明を公開します(助言)。



研究中に得られたデータを体系化する過程で、研究センターの専門家からの記事が公開され、人気のある雑誌および有名なインターネットサイト(ロシア語(Habrahabr、Hacker雑誌)および外国語(Hakin9など))に掲載されます。



同様に、マーケティングとPRの問題を解決するプロセス(会社のポジショニング、Positive Hack Daysフォーラムの報道)では、多数のテキストが表示されます。これらはブログエントリ、ソーシャルネットワークに関するメモ、印刷された販促資料です。 これらのテキストはすべて、技術文書部門を通過します。



すべてのテキストで作業する場合、さまざまなパラメータを考慮する必要があります-タスクの優先度、翻訳と編集の必要性、期限。 これを行うには、プロジェクト管理システムを使用してTestTrackに基づいたドキュメントを開発します。これにより、重要なドキュメントの無限の雪崩に埋もれないようになります。







Habréとインターネット一般の両方で技術文書の開発のトピックに専念する資料はほとんどないという事実にもかかわらず、非常に興味深いものです。 このトピックを読んだ後に質問がある場合は、コメントでお答えします。 ご清聴ありがとうございました!



PS私たちは常に、外国語に堪能な、技術に精通した有能な人材を求めています。 テクニカルライターおよび翻訳者の若くて前向きなチームで働きたい場合は、お知らせください!



All Articles