テクニカルライター

テクニカルライターは、複雑な情報を一般大衆やごく限られた読者に分かりやすい言葉で伝えることを仕事とするプロのコミュニケーターです。テクニカルライターは、さまざまな配信メディア（電子、印刷、視聴覚、さらにはタッチ）を通じて情報を調査および作成します。^[1]情報の種類の例には、オンラインヘルプ、マニュアル、ホワイトペーパー、設計仕様、プロジェクト計画、ソフトウェアテスト計画などがあります。eラーニングの台頭により、オンライントレーニング教材の開発にテクニカルライターが採用されることが増えています。

テクニカルコミュニケーション協会（STC） によると：^[2]

テクニカル ライティングは、複雑なものを単純化すると定義されることがあります。このように簡潔で、一見単純な定義には、人間のあらゆる活動の分野に何らかのレベルで対応する一連のスキルと特性が内在しています。テクニカル コミュニケーションというより広範な分野の重要なサブセットであるテクニカル ライティングには、タスクや目標を達成するために複雑な情報を必要とする人々に伝えることが含まれます。

言い換えれば、テクニカルライターは高度な技術概念を取り上げ、それを対象読者に可能な限り明確かつ正確に、包括的に伝え、その作品がユーザーにとってアクセスしやすいものであることを保証します。

カート・ヴォネガットはテクニカルライターを次のように表現した。^[3]

...自分の文章で自分自身についてほとんど何も明かさないように訓練されている。そのため、彼らは作家の世界では異端者となっている。なぜなら、その世界の他のインクまみれのろくでなしのほとんど全員が、読者に自分自身について多くのことを明かしているからだ。

エンジニア、科学者、その他の専門家もテクニカル ライティング(開発編集、校正など) に携わる場合がありますが、読者に情報を届ける手段として、資料の開発、編集、フォーマット、確立されたレビュー手順の実行を専門のテクニカル ライターに依頼する可能性が高くなります。

テクニカルコミュニケーション協会（STC） によると、テクニカルコミュニケーションとテクニカルライティングの専門職が初めて言及されたのは、第一次世界大戦の頃で^[2]、軍事目的で技術文書が必要になったときです。この職種は、第二次世界大戦中に米国で登場しました。^[4]ただし、最初の「テクニカルライター募集」の広告が掲載されたのは1951年になってからでした。^[5]実際、「テクニカルライター」という職種は、2010年まで米国労働統計局の職業雇用ハンドブックに追加されませんでした。 ^[6] 1940年代から50年代にかけて、テクニカルコミュニケーターとライターは、軍用の文書を作成するために雇用され、新しい兵器の詳細な手順を含むことが多かったです。他のテクニカルコミュニケーターとライターは、この頃に開発された新しい技術の文書の作成に携わっていました。オハラによると：^[7]

戦争は科学技術の進歩の最も重要な原動力でした。米国陸軍医療部隊はパナマのジャングルでマラリアと闘い、化学部隊は爆発物や有毒ガス（およびそれらに対する防御）の化学的進歩を推進し、工兵隊のマンハッタン地区は物理学の理解において文字通り飛躍的な進歩を遂げ、航空部隊は航空機の設計の先駆者となりました。

テクニカル ライターは、この職業が始まった当初から、他のテクニカル ライターとチームを組んで仕事をしてきました。今日でも、ほとんどの組織では、担当する製品やサービスのテクニカル ライティングの作成と編集を行うチームを雇用しています。チームのメンバーとして、テクニカル ライターは担当する業務について独自に調査を行います。主題専門家 (SME) との定期的な 1 対 1 のミーティングや社内の調査資料 (機械図面、仕様、BOM、データシートなど) により、テクニカル ライターはドキュメントの正確性を確保するために必要なチェックを受けることができます。担当する SME がドキュメントの正確性を確認し、承認すると、テクニカル ライターは執筆チームにピア レビューを依頼します。ピア レビューは、コンテンツの形式、スタイル、文法の標準化のみに焦点を当てます。チームのピア レビューの目的は、組織のテクニカル ライティングが「統一された意見」で表現されるようにすることです。

第二次世界大戦中、テクニカル ライターにとって最も重要な特性の 1 つは、文書に関する政府の厳格な仕様に従う能力でした。^[7]戦後、コンピューターなどの新しいテクノロジーの台頭により、テクニカル ライターは他の分野で働くことができるようになり、^[7]「ユーザー マニュアル、クイック リファレンス ガイド、ハードウェア インストール マニュアル、カンニング ペーパー」を作成しました。戦後 (1953 ～ 1961 年)、テクニカル コミュニケーター (テクニカル ライターを含む) は、自分の分野を「専門化」することに興味を持つようになりました。^[6]マローンによると、^[6]テクニカル コミュニケーター/ライターは、専門組織を作成し、職業のための「専門的な知識体系」を育成し、テクニカル コミュニケーターに倫理基準を課し、その分野の専門家の認定に関する話し合いを開始し、その分野の教育プログラムの認定に努めることで、専門化を実現しました。

この職業は成長を続けており、オハラによれば、テクニカルライターを含むライティング/編集の職業は、1994年から2005年の間にポジションが22%増加しました。^[7]現代のテクニカルライターは、さまざまな状況で働いています。多くのテクニカルライターは、VPNを使用してリモートで作業するか、 SkypeやZoomなどのビデオ電話プラットフォームを介してチームと通信します。他のテクニカルライターは、オフィスで働いていますが、ドキュメントをオンラインで保存する複雑なコンテンツ管理システムを介してチームとコンテンツを共有しています。テクニカルライターは、政府のレポート、社内文書、技術機器の説明書、ソフトウェアまたはシステム内の埋め込みヘルプ、またはその他の技術文書に取り組む場合があります。テクノロジーが進歩し続けるにつれて、テクニカルライターの可能性の範囲は拡大し続けます。多くのテクニカルライターは、モバイルアプリケーションの技術文書や、モバイルアプリケーションまたはWebアプリケーション内に構築されたヘルプドキュメントの作成を担当しています。ハンドヘルドデバイスでのみ表示されるコンテンツの作成を担当している場合もあります。彼らの仕事の多くは、過去の技術文書のように印刷された小冊子で公開されることはありません。

歴史的に、テクニカルライター、またはテクニカルおよびプロフェッショナルコミュニケーターは、ライティングとコミュニケーションに携わってきました。しかし、最近では、企業が幅広いオーディエンスとエクスペリエンスに向けたコンテンツの開発に取り組んでいるため、ユーザーエクスペリエンス（UX）デザインがテクニカルおよびプロフェッショナルコミュニケーションにおいてより重要になってきています。^[8]

ユーザーエクスペリエンス専門家協会は、UXを「製品、サービス、または企業とユーザーの相互作用のあらゆる側面であり、ユーザーの全体に対する認識を構成するもの」と定義しています。^[9]したがって、「ユーザーエクスペリエンスデザインは、レイアウト、ビジュアルデザイン、テキスト、ブランド、サウンド、インタラクションなど、インターフェイスを構成するすべての要素に関係する分野です。」^[9]

今では、テクニカルコミュニケーションスキルはUXデザインと組み合わせる必要があると期待されています。Verhulsdonck、Howard、Thamは次のように述べています。「...良いコンテンツを書くだけでは十分ではありません。業界の期待によると、良いコンテンツを書くことに加えて、そのコンテンツを中心に良い体験をデザインすることも今では重要です。」^[8]テクニカルコミュニケーターは、ソーシャルメディアやアプリなどのさまざまなプラットフォーム、およびWebやモバイルなどのさまざまなチャネルを考慮する必要があります。^[8]

レディッシュが説明するように、テクニカルコミュニケーションの専門家はもはやコンテンツを書くのではなく、コンテンツを取り巻くユーザーエクスペリエンスが開発されるにつれて「インターフェースを中心に書く」ようになります。これには、UXエコロジーのさまざまなチャネルにわたるユーザーの感情、気持ち、考えに対応する、特定のユーザーニーズに合わせてカスタマイズされた使いやすいコンテンツが含まれます。^{[10] [8]}

ラウアーとブルンベルガーはさらに、「UXは、特にコンテンツが幅広いインターフェースや環境に展開されるレスポンシブデザインの現代の技術的文脈において、テクニカルコミュニケーターがすでに行っている仕事の自然な延長である」と主張している。^[11]

UXデザインは、技術的なコミュニケーションとユーザーのアイデンティティの両方から生まれます。効果的なUXデザインは、デザインエスノグラフィーと呼ばれるプロセスで、ユーザーの固有の背景に応じて使いやすさを最大化するように構成されます。^[12]デザインエスノグラフィーでは、インタビューやユーザビリティテストを通じてユーザー文化を詳細に分析します。テクニカルライターはユーザー環境に直接入り込み、ローカルユーザーからUX情報を収集します。

確かな調査、言語、執筆、修正のスキルに加えて、テクニカル ライターには次のようなスキルが必要です。

テクニカル ライターは、高度な消費者情報の作成など、非技術的なコンテンツの作成にスキルを応用する場合があります。通常、テクニカル ライターは主題専門家(SME) ではありませんが、SME にインタビューし、技術的に正確なコンテンツの作成と編集に必要な調査を実施します。テクニカル ライターは、トピックを完全に理解するために、一次調査と二次調査の両方を実施します。^{[引用が必要]}

優秀なテクニカルライターは、技術資料を簡潔かつ効果的に作成、理解、伝達する能力を持っています。特定の分野に特化している場合もありますが、記述する製品について十分な理解を持っている必要があります。^[14]たとえば、APIライターは主にAPIドキュメントを扱いますが、他のテクニカルライターは電子商取引、製造、科学、医療資料を専門としています。^[14]

テクニカル ライターは、さまざまな情報源から情報を収集します。通常、情報源は開発者からマーケティング部門まで組織全体に分散しています。

Markelによると^[15] 、有用な技術文書は「正直さ、明瞭さ、正確さ、包括性、アクセシビリティ、簡潔さ、プロフェッショナルな外観、正確さ」の8つの特性によって評価されます。テクニカルライターは、慎重な調査を行って、これら8つの特性を満たす効果的な文書を作成することに重点を置いています。

効果的な技術文書を作成するには、作成者は特定のプロジェクトの修辞的状況を構成する3つの要素、つまり対象読者、目的、コンテキストを分析する必要があります。^[16]次に、読者が目にするものを決定する文書デザインが続きます。

テクニカルライターは、複雑な概念やプロセスを簡素化して、読者の理解を最大限に高めようと努めます。特定のドキュメントの最終目標は、読者が必要なものを見つけ、見つけたものを理解し、理解したものを適切に使用できるようにすることです。^[17]この目標を達成するには、テクニカルライターは読者がドキュメントをどのように使用し、読んでいるかを理解する必要があります。ドキュメントプロジェクトの開始時にオーディエンス分析を行うと、特定のドキュメントのオーディエンスが何を求めているかを定義するのに役立ちます。

読者を分析する際、テクニカルライターは通常次のような質問をします。^[17]

• 対象読者は誰ですか?
• 彼らの人口統計学的特徴は何ですか?
• 観客の役割は何ですか?
• 読者はこの主題についてどう感じているでしょうか?
• 読者は送信者に対してどのように感じているでしょうか?
• 読者はどのような形式を期待しているでしょうか?
• 観客の課題は何でしょうか?
• なぜ視聴者はそのタスクを実行する必要があるのでしょうか?
• 視聴者の知識レベルはどの程度ですか?
• 状況に影響を与える要因は何ですか?

正確な対象者分析により、ドキュメントの内容、デザインとプレゼンテーション (オンライン ヘルプ システム、インタラクティブな Web サイト、マニュアルなど)、トーン、知識レベルを決定する一連のガイドラインが提供されます。

テクニカルライターは、コミュニケーションの目的（または機能）を分析して、文書が達成しなければならないことを理解します。コミュニケーションの目的が読者を「特定の方法で考えたり行動したりすること、タスクを実行できるようにすること、何かを理解するのを助けること、態度を変えること」などである^かどうかを判断することで、テクニカルライターはコミュニケーションの形式や、選択するコミュニケーションの種類（オンラインヘルプシステム、ホワイトペーパー、提案書など）を決定できます。

コンテキストとは、読者がコミュニケーションを使用する物理的および時間的な状況です。たとえば、オフィスのデスク、製造工場、夏の閑散期、会社の危機の真っ最中などです。^[16]状況のコンテキストを理解することで、テクニカルライターは読者がどのようにコミュニケーションを使用するかを知ることができます。この知識は、ライターがコミュニケーションをフォーマットする方法に大きな影響を与えます。たとえば、ドキュメントが小型船舶のコントロールに関する簡単なトラブルシューティングガイドである場合、ライターはページをラミネートして使用可能期間を延ばす場合があります。

上記の情報が収集されると、文書は最適な読みやすさと使いやすさを考慮して設計されます。ある専門家によると、テクニカルライターは、技術的コミュニケーションを計画および作成するために、配置、強調、明瞭さ、簡潔さ、トーン、精神の6つのデザイン戦略を使用します。^[16]

配置

視覚的要素の順序と構成。これにより、読者は要素の構造（グループ内でどのようにまとまっているか、互いにどのように異なっているか、レイヤーや階層をどのように作成しているか）を理解できるようになります。^[16]配置を検討する際、テクニカルライターは見出し、リスト、チャート、画像をどのように使用して使いやすさを向上させるかを検討します。

強調

文書が重要なセクションを目立つように、または強調して表示する方法。^[16]強調を考慮する場合、テクニカルライターは、配置、太字、色、文字サイズを使用して、読者に重要なセクション、警告、役立つヒントなどをどのように示すことができるかを検討します。

明瞭性

「受信者がメッセージを解読し、それを迅速かつ完全に理解し、必要に応じて曖昧さなく反応するのを助ける」戦略。^[16]明瞭性を考慮すると、テクニカルライターは、読者の理解を妨げる可能性のある、低いコントラスト比、過度に複雑なチャートやグラフ、判読できないフォントなどの視覚的なノイズを減らすよう努めます。

簡潔

デザインの「視覚的な量と複雑さ」、たとえば、見出しやリスト、線やボックスの数、図面やデータ表示の詳細、サイズのバリエーション、装飾性、テキストの間隔など。^[16]テクニカルライターは、読者が文書を簡単に使用できるようにするために、これらすべてのデザイン戦略を考慮する必要があります。

トーン

文書の音や雰囲気。文書の種類と読者によって、コミュニケーションがフォーマルでプロフェッショナルなものになるか、それとも気楽でユーモラスなものになるかが決まります。言語の選択に加えて、テクニカル ライターは、スペース、画像、書体などを使用して、テクニカル コミュニケーションの雰囲気を設定します。

精神

文書内で視覚言語が達成する信頼性の度合い。^[16]テクニカルライターは、読者の信頼を得るために、専門的でエラーのない文書を作成するよう努めています。

テクニカルライターは通常、技術とライティングの両方の能力を持っています。彼らは通常、技術分野の学位や資格を持っていますが、ジャーナリズム、ビジネス、その他の分野の学位や資格を持っていることもあります。多くのテクニカルライターは、ジャーナリズムなどの他の分野、またはエンジニアリングや科学などの技術分野から転職しますが、多くの場合、テクニカルコミュニケーションの授業で重要な追加スキルを学んだ後に転職します。^[18]

技術文書を作成するには、テクニカル ライターは主題、目的、対象読者を理解する必要があります。テクニカル ライターは、既存の資料を調べたり、SME にインタビューしたり、多くの場合は実際に製品を使用したりして情報を収集します。対象読者を調査して、そのニーズと技術理解レベルを把握します。

技術出版物の開発ライフサイクルは、通常、製品開発計画全体と連携した5つのフェーズで構成されています。^[19]

• フェーズ1: 情報収集と計画
• フェーズ2: コンテンツの仕様
• フェーズ3: コンテンツの開発と実装
• フェーズ4: 生産
• フェーズ5: 評価

ドキュメント開発ライフサイクルは、通常、6 つのフェーズで構成されます (組織によって従う方法が異なります)。

1. オーディエンスプロファイリング（ターゲットオーディエンスの特定）
2. ユーザータスク分析（対象ユーザーに基づいてタスクと情報を分析）
3. 情報アーキテクチャ（分析に基づく設計、文書の作成方法）
4. コンテンツ開発（ドキュメントの開発/準備）
5. 技術および編集レビュー（マネージャーなどの上級者とのレビュー）
6. 書式設定と公開（ドキュメントを公開します）。

これはソフトウェア開発ライフサイクルに似ています。

よく書かれた技術文書は、通常、正式な標準またはガイドラインに従っています。技術文書には、媒体や主題領域に応じて、さまざまなスタイルと形式があります。印刷された文書とオンライン文書はさまざまな点で異なる場合がありますが、それでも散文、情報構造、レイアウトに関するほぼ同じガイドラインに従っています。通常、テクニカル ライターは、標準スタイル ガイドで説明されている書式設定規則に従います。米国では、テクニカル ライターは通常、Associated Press StylebookまたはChicago Manual of Style (CMOS) を使用します。多くの企業には、ロゴの使用、ブランド化、および企業スタイルのその他の側面など、特定の企業の問題を​​網羅した社内スタイル ガイドがあります。Microsoft Manual of Style for Technical Publications は、これらの典型的なものです。

エンジニアリング プロジェクト、特に防衛または航空宇宙関連のプロジェクトでは、民間航空機の場合は ATA100、民間および防衛プラットフォームの場合は S1000D など、国内および国際的なドキュメント標準に従うことがよくあります。

テクニカルライターは、多くの場合、執筆チームまたはプロジェクト開発チームの一員として働きます。通常、ライターは草稿を仕上げ、それを 1 人以上の SME に渡して、正確性と完全性を確認するテクニカルレビューを実施します。別のライターまたは編集者が編集レビューを実施し、スタイル、文法、読みやすさの適合性をチェックします。この人物は、説明を求めたり、提案したりすることがあります。場合によっては、ライターまたは他の人が、ドキュメントを聴衆にテストして、使いやすさを改善します。最終的な制作物は通常、検査チェックリストに従って、公開された製品の品質と統一性を確保します。^[20]

企業に雇用されているテクニカルライターの物理的な作業環境は、通常、デスクトップコンピュータと個別のデスクを備えたオープンオフィスです。テクニカルライターのワークスペースは、業界によって大きく異なります。2018年にインターコムが実施した、主にアメリカ人のテクニカルコミュニケーターを対象とした国勢調査では、回答者の大多数がテクノロジーとITの分野で働いていました。^[21]テクニカルライティングにおけるさまざまな業界の普及は、地理的な場所や、世界の特定の地域で最も一般的な業界と相関しています。ヨーロッパのテクニカルコミュニケーションのキャリアに関する調査では、テクニカルコミュニケーターの大多数がIT分野で働いていることが示されました。

2020年3月に世界保健機関（WHO）がCOVID-19パンデミックによる外出自粛を勧告したことを受けて、世界中の従業員は対面からリモートやバーチャルへの労働環境の変化を経験しました。2023年現在、社会的距離政策が緩和された後、多くの組織は従業員がリモートで働くオプションを維持することを決定しました。特にプロのテクニカルライターの場合、この変化により、技術コミュニケーションプロセスに直接関与する主題専門家、同僚、プロジェクトマネージャーとのコミュニケーションに別のアプローチを余儀なくされます。リモートで働く従業員は通常、協力者とのバーチャルな、時には非同期のコミュニケーションに依存し、自宅または隔離されたオフィスで勤務時間を過ごします。^[22]

テクニカル ライターには標準的なキャリア パスは 1 つではありませんが、他のライターよりもプロジェクト管理職に就く可能性があります。ライターは、上級テクニカル ライターのポジションに昇進し、複雑なプロジェクトやライターと編集者の小規模なチームを担当する場合があります。大規模なグループでは、ドキュメント マネージャーが複数のプロジェクトやチームを担当する場合があります。

テクニカル ライターは、特定の技術分野で専門知識を習得し、ソフトウェア品質分析やビジネス分析などの関連分野に進出することもあります。ある分野の専門家になったテクニカル ライターは、テクニカル ライティングからその分野の仕事に転向する場合があります。テクニカル ライターは、クラスルーム ガイドや e ラーニングなど、文書化したテクノロジのトレーニングを作成することが多く、中にはプロのトレーナーや教育設計者として専門化していく人もいます。

ライティングスキルの専門知識を持つテクニカルライターは、印刷メディアや電子メディアの企業に入社することができ、収入の増加や労働条件の改善の機会が得られる可能性があります。

2021年4月、米国労働省は、テクニカルライターの雇用が2019年から2029年にかけて7％増加すると予想しており、これは全職業の平均よりもわずかに速いペースである。彼らは、特に技術スキルを持つ応募者にとって、就職機会は良好になると予想している。BLSはまた、「科学的および技術的製品」の拡大と、「Webベースの製品サポート」で働くテクニカルライターの必要性が、需要の増加を促進すると指摘した。^[23]

ZipRecruiterによると、2022年5月現在、米国のフリーランステクニカルライターの平均年収は70,191ドルである。^[24]

• テッド・チャンは、アメリカの短編小説作家で、『Story of Your Life』（1998年）や『The Merchant and the Alchemist's Gate』（2007年）などの著書があり、2002年7月までソフトウェア業界のテクニカルライターとして活動していた。^[25]
• 『JR』（1975年）や『A Frolic of His Own 』（1994年）の著者ウィリアム・ギャディスは、最初の小説『The Recognitions 』（1955年）があまり評価されなかった後、ファイザーやイーストマン・コダックなどの企業で15年間テクニカルライターとして働いていた。^[26]
• ホワイトペーパーの専門家であり、元ライティング教授であるゴードン・グラハム氏。
• マイケル・ハルヴォルソンは、アメリカの技術ライターであり歴史家であり、大学教授であり、コンピュータプログラミング、PC ソフトウェアの使用、技術の歴史に関する 40 冊の本の著者です。
• ダン・ジョーンズ、大学教授、技術コミュニケーション協会会員。
• ファイト・クラブのアメリカの著者チャック・パラニュークは、小説家になる前はディーゼル整備士や自動車技術ライターとして働いていた。 ^[27]
• 『禅とオートバイ整備術：価値観の探究（ZAMM）』 （1974年）の著者ロバート・M・ピルジグは、このベストセラー本の執筆に携わりながら、IBM の技術マニュアルも執筆しました。
• アメリカの作家で、『ロット49番の叫び』（1966年）、『重力の虹』（1973年）、『メイソン＆ディクソン』 （1997年）などの著書を持つトーマス・ピンチョンは、1960年から1963年までボーイング社のテクニカルライターとして勤務していた間に、初の小説『V 』（1963年）を執筆した。
• ジョージ・サンダースは、アメリカの作家で、『Tenth of December: Stories』（2013年）やその他の短編小説集、エッセイ、中編小説を執筆しており、ニューヨーク州ロチェスターの環境エンジニアリング会社、ラディアン・インターナショナルでテクニカルライター兼地球物理学エンジニアとして働きながら、初の短編小説集『 CivilWarLand in Bad Decline』（1996年）を執筆しました。
• エイミー・タンは、アメリカの作家で、『ジョイ・ラック・クラブ』（1998年）、『ボーンセッターの娘』（2001年）などの高く評価された小説を著した。タンはテクニカルライターとして働いていたころからフィクション小説を書き始めた。^[28]
• リチャード・ウィルバー、アメリカの詩人。会話の中で言及しているように、ボーイング社に勤務していた。
• マリオン・ウィニックはアメリカの作家、エッセイストであり、1984年から1994年までテキサス州オースティンのユニゾン・ティムラボでテクニカルライターとして働いていた。^[29]

テクニカル ライターには、テクニカル コミュニケーター、 情報開発者、テクニカル コンテンツ開発者、テクニカル ドキュメンテーション スペシャリストなど、さまざまな職種があります。英国やその他の国では、テクニカル ライターはテクニカル オーサーまたはナレッジ オーサーと呼ばれることがよくあります。

• 共同編集
• 欧州技術コミュニケーション協会
• ソフトウェアドキュメント

Wikiversityにはテクニカルライティングに関する学習リソースがあります

• ウィキメディア・コモンズのテクニカルライター関連メディア
• テクニカルライター向けの標準の説明とリンク
• テクニカル ライティング教育プログラム - ロサンゼルス支部、テクニカル コミュニケーション協会(LASTC)
• ISO/IEC JTC 1/SC 7 ISO/IEC JTC 1/SC 7 - ワーキンググループ2はソフトウェアドキュメントの国際標準を開発します