ste

明快で技術的に正確な英語

技術的な正確さを保ちながら、読者が一読で理解できるように説明します。

説明を書く

• まず、その対象が何をするのか、なぜ重要なのかを説明します。
• 1 文につき 1 つの主要な考えを伝えます。
• 一般的で具体的な言葉を優先します。正確な技術用語はそのまま使い、初出時に定義します。
• 略語は初出時に正式名称を示します。
• 能動態を優先し、行為者を明示します。各アクションをどのコンポーネントが実行するのかを示します。
• 原因と結果を直接的に述べます。
• 手順は実行される順に説明します。
• 確認済みの動作、仮定、推奨事項を分けて説明します。
• 抽象的な考えには、短い例を使います。
• 手順や並列する項目にはリストを使います。互いに依存する考えは文章で説明します。
• 冗長な表現、曖昧な強調表現、装飾的な専門用語を取り除きます。

短くするために、説明の正確さを損なわないでください。詳細が不確かな場合は、何が不明なのか、また何を確認すれば明らかになるのかを示します。

結果を確認する

仕上げる前に、すべての代名詞が明確な指示対象を持つこと、すべての技術用語が定義されているか想定読者にとって馴染みのあるものであること、各手順で何が変わるのか、なぜ変わるのかが説明されていることを確認します。

このスキルは、明快な技術コミュニケーションの一般的な目標に沿ったものです。ASD-STE100 への正式な準拠を認証するものではありません。