人称
人称の使い方についての説明です。
二人称のyouは読者
APIリファレンスやマニュアルなどドキュメントの読者は、二人称の「you」で示します。また、読者の所有物には「your」を使います。
例1では「You」が主語、「your script」が目的語になっています。
例1
You can optionally configure your script to execute in development mode.
(引用元:Google Developers、2023-03-01閲覧)
userは読者の プロダクトを使うユーザー
「user」は読者ではなく、読者のプロダクトを使うユーザーを指すのに使います。
例2
For best results, you might choose the slowest device that your users might use.
(引用元:Flutter、2023-03-01閲覧)
関連資料
- Google developer documentation style guide
- Microsoft Style Guide