お客様には二人称で呼びかけます。それが難しい場合は、ジェンダーニュートラルな代名詞を使います。代名詞として "one" は使いません。
代名詞がだれ、または何を指すかを明確にします。代名詞は文の主語を示す道しるべであり、主語が分からなくなるほど多用してはいけません。
Cloudflare を主体として書く必要があるときは、"we" や "I" を "Cloudflare" に置き換えます。"we" を常に使う必要はありません。ただし、文法上それが最適なときは使います。
| ✅ | ❌ |
|---|---|
| Cloudflare recommends you submit image or plain text files. | We recommend closing your files before you restart your computer. |
手順を書くときは、二人称の "you" を使った丁寧な命令形にします。特別な場合は "they" や "it" を使います。
読者が Cloudflare 製品の利用者であるときは、「the user」ではなく "you" を使います。
主語が自明または不要なときは、最後の手段として受動態を使います。