『Microsoft Manual of Style: Your Everyday Guide to Usage, Terminology, and Style for Professional Technical Communications ( MSTP )』(旧版ではMicrosoft Manual of Style for Technical Publications ) は、 Microsoftが発行したスタイル ガイドです。第 4 版 ( ISBN 0-7356-4871-9 ) は 2012 年に発行されました。Microsoftの従業員とパートナーは、 Microsoft Compressed HTML Help (CHM) バージョンにもアクセスできました。
2018 年に、この本は Web サイト「Microsoft Writing Style Guide」に置き換えられ、Apple スタイル ガイドや Google Developer Documentation スタイル ガイドなどの他のオンライン ガイドに加わりました。
歴史
- 初版: 1995年発行(ISBN 1-55615-939-0)
- 第2版: 1998年6月発行(ISBN 1-57231-890-2)
- 第3版: 2004年6月発行(ISBN 0-7356-1746-5)
- 第4版: 2012年1月発行(ISBN 0-7356-4871-9)
目的
他のスタイル ガイドと同様に、MSTP は標準を確立し、ライターのリファレンスとして機能します。MSTP の具体的な目的は、Microsoft製品を扱うテクニカル ライター、編集者、コンテンツ マネージャーをガイドすることです。マニュアルの一部ではこれらの製品に特有の使用法に焦点を当てていますが、このガイドはテクニカル ライターの一般的なツールとしても機能します。内容は、特定のプログラムの特定の要素に名前を付けるための具体的な手順から、一般的な文法規則まで多岐にわたります。
コンテンツ
MSTP は、序文と概要に続く 2 つの部分に分かれています。
パート 1 は「一般的なトピック」というタイトルで、次の 11 の章に分かれています。
- Web コンテンツ: Web、ビデオ、ブログ、国際的考慮事項、アクセシビリティ、法的考慮事項など、あらゆる種類の Web コンテンツのパラメータを定義します。
- Microsoft のスタイルと音声: 基本原則とスタイル ガイド。
- 世界中の読者向けのコンテンツ: ローカルな参照を避け、テキストを簡単に翻訳できるようにすることで、ドキュメントが世界中で理解されるようにするための手順を示します。
- アクセシブルなコンテンツ: デザイン、グラフィック、テキストを含むすべての領域におけるアクセシビリティについて説明し、許容される用語を参照します。
- ユーザー インターフェイス: Microsoft ユーザー インターフェイスの要素に標準化された名前を提供します。
- 手順と技術コンテンツ: 手順やその他の技術コンテンツの一貫したフォーマットに関するガイドラインを提供し、ユーザーが重要な情報を迅速かつ効率的に見つけられるようにします。
- スタイルの実際的な問題: 大文字の使用から、日付、数値、測定値などのスタイル要素の書式設定に至るまで、一般的な問題を指摘します。
- 文法: 動詞と名詞の一般的な使用法に関するセクションが含まれています。
- 句読点: 句読点の使用に関する情報が含まれています。
- インデックスとキーワード: ユーザーがコンテンツを見つけられるように、コンテンツのインデックス作成や属性付けに関するガイドラインを提供します。
- 頭字語およびその他の略語: 混乱を避けるために頭字語と略語をどのように、いつ使用するかを含め、頭字語と略語の一貫した使用に関するガイドラインを提供します。また、頭字語と略語のリストも含まれています。
パート 2 は、技術文書でよく使用される用語をアルファベット順に並べた「使用法辞書」です。
外部リンク
- 公式サイト
