问在用户手册中使用“你”这个词

EN

有些人认为，手册应该写得像科学论文一样。其他人认为技术上的准确性和可读性更重要。我属于后一种说服方式--如果符合你的整体风格，就使用“你”，但你的用法要一致--我发现在“你”和“我们”之间切换的文档令人恼火(这是我为自己感到内疚的罪过)。

据我所知，其他的选择是：

the table."

• Imperative‘You’(第二人称单数)-- "The user‘ table."
• Passive on table.“
  • Imperative--”把盘子放在桌子上。"The
  • ’我们‘(第一人称复数)--“我们应该把盘子放在桌子上。”
  • ’the user‘(第三人称单数)--“the user should the singular on table.”
    • Passive-“盘子应该放在桌子上。”

    。

我自己的偏好是：

• 我更喜欢使用命令式作为默认模式，因为它是最简短的(用词最少)。
• 我避免被动，避免第一人称复数。
• 当我想要一个明确的主语而不是命令式时，我会使用第二人称代词(“你”)或第三人称名词(例如“你的系统管理员”)。

哪一个更容易理解？

单击该按钮。您将看到一个对话框，您可以在其中键入您的姓名。

或

单击按钮的动作将导致出现一个对话框，允许用户输入他或她的姓名。

第一种方法更容易掌握。(有时使用"you“可能会很草率，但这往往是用来代替"one”、"some people“或"people in general”的情况。在你实际指的是阅读文本的人的地方使用它是很好的。)