Googleが公開している開発者向け英文スタイルガイドから項目を1つ取り上げて紹介します。スタイルガイドは基本的には書く際に利用されますが、読む際にも参考になります。
リストの使い方(2)
URL:https://developers.google.com/style/lists (アクセス:2020-03-19)
今回は、情報を見やすく整理するリストの使い方に関する第2回目です(1回目はウェブ上にも掲載)。
導入文
項目を列挙するリストの前には「導入文」を置きます。直後に項目を列挙する場合、導入文の末尾はコロン(:)とします。
良い例1:
Use the Submit button for any of the following purposes:
– To submit the form.
– To indicate that you’re done.
– To allow the next person to enter their data.
良い例2:
To get the USB driver, follow these steps:
1. Click Tools > Android > SDK Manager.
2. Select Google USB Driver, and then click OK.
良い例1を見ると「… the following purposes:」とあります。「following」は形容詞で「以下の〜」、名詞で「以下のもの」という意味があります。非常に便利に使える単語なので、ぜひ覚えておいてください。
また導入文は、それ自体で完全な文の形とし、各項目の末尾まで読んだら完全な文となるようには書きません(以下の悪い例)。
悪い例:
Use the Submit button to:
– Submit the form.
– Indicate that you’re done.
– Allow the next person to enter their data.
→ 1つめの項目の場合、「Use the Submit button to submit the form.」と末尾まで読んで初めて完全な文となる。そのため良くないとされる
項目内のピリオド
リストの各項目は大文字で書き始めます。また末尾にピリオドを付けるかどうかは、日本語でも悩ましいですが、Google開発者スタイルガイドでは大まかな指針を以下としています。
- 項目が1つの単語で構成される場合、ピリオドは付けない
- 項目に動詞が含まれない場合、ピリオドは付けない
- 項目全体にソースコード用フォントが使われる場合、ピリオドは付けない
Googleによる例を見てみます。
良い例1:
The following words are adjectives:
– Big
– Small
– Gratuitous
良い例2:
You can do any of the following by using the API:
– Create an item.
– Replace one item with another.
– Update an item.
– Delete an item.
→ 動詞なのでピリオドあり。またここのfollowingは名詞で、常に単数形で使う(followingsとしない)
(ライセンス表示: Portions of this page are modifications based on work created and shared by Google and used according to terms described in the Creative Commons 4.0 Attribution License.)
[筆者紹介]