略語
略語には、頭字語、イニシャリズム、短縮形、そして省略形が含まれます(ほとんどの文脈では、頭字語とイニシャリズムの技術的な区別は重要ではありません; 両方を指すために頭字語という言葉を使うことは問題ありません)。
いくつかの単語には、長いバージョンと短いバージョンがあります。例えば、「application」と「app」、「demonstration」と「demo」、「synchronize」と「sync」です。
単語の短いバージョンは略語ではなく、それを使用する場合は、後にピリオドを付ける必要はありません。
単語が略語なのか、単に長い単語の短いバージョンなのか不明な場合は、一般的な略語のリスト ↗を参照してください。それでも問題が解決しない場合は、発音テストを使用します: 短いバージョンを単語として発音する場合(「これは製品のデモバージョンです」)、通常はそれを単語として扱い、略語とは見なさないことができます。
Cloudflareダッシュボードの標準用語が単語の長いバージョンである場合は、一貫性と区別を維持するために、短いバージョンではなくその長いバージョンを使用してください。例えば、Cloudflare for Teamsの顧客applicationsはappsに短縮されません。使用ケースによっては、特に翻訳の観点から、applicationが好まれる用語かもしれません。
一般的に、略語が聴衆にとって不明である可能性が高い場合、用語の最初の言及を明記し、すぐに略語を括弧内に続けて記載します。その後の略語のすべての言及では、略語だけを使用します。
用語の最初の言及が見出しやタイトルにある場合は、略語を使用し、その後の最初の段落で略語を明記することができます。
用語を明記するかどうかを決定する際は、聴衆を考慮してください。聴衆の大多数がその用語を認識し理解できる可能性が高い場合は、明記する必要はありません。例えば、APIを参照する開発者向けのドキュメントを書く場合、application programming interfaceを明記する必要はありません。しかし、プログラミング経験のない人にAPIの一般的な概念を説明する場合、略語を明記することが役立つことがあります。
場合によっては、用語を明記しても読者がその用語を理解するのに役立たないことがあります。例えば、portable document formatと書いても、PDF文書が何であるかを理解するのに役立ちません。そのような場合は、用語を明記しないでください。
以下の略語は、ほとんどの場合明記する必要はありません:
- API
- DVD
- PDFやXMLなどのファイル形式
- HTML
- PC
- RAM
- REST
- MBやGBなどの単位
- URL
- USB
ラテン略語よりも英語の用語を優先してください。i.e.やe.g.は使用しないでください。代わりに、つまりや例えばを使用してください。
一つの例外として、etc.とand so onは可能な限り避けてくださいが、本当に必要な場合は*etc.*を使用してください。常にピリオドを含めてください、たとえその後にコンマが続く場合でも。
tl;dr、IMO、FYIなどのインターネットスラングの略語は使用しないでください。
単語の最も一般的な形を使用してください。完全に書かれた単語が一般的で理解しやすい場合は、略語ではなくそれを使用してください。例えば、approx.の代わりにapproximatelyを書き、vs.の代わりにversusを書いてください。
以下のガイドラインに従ってください:
- 頭字語やイニシャリズムにはピリオドを使用しないでください。
- 短縮形の単語の末尾にはピリオドを付けてください。ただし、日付や時間の略語は除きます。
- 略語を単語として書いたり言ったりする場合(例えば、appやsync)、その後にピリオドを付けないでください。
- 国名、米国の州名、またはコロンビア特別区(DC)の略語にはピリオドを使用しないでください。
似ているようで、これらの2つのラテン略語は非常に異なる意味を持っています。
- i.e.はid estの略です。文字通り「つまり」という意味です(that = id, est = is)。「つまり」や「言い換えれば」に置き換えることができます。
- Gzipによって達成された中央値の圧縮率は0.65%でした(i.e.、ページはそのサイズの0.65%に縮小されました)。
- e.g.はexempli gratiaの略です。これは、あなたがちょうど言及した何かの例を紹介する際に使用します。「例えば」や「のような」に置き換えることができます。
- Cloudflare製品(e.g.、Zero Trust、Magic Transitなど)は、ネットワークのセキュリティと信頼性を提供します。