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

Question

我正在写一本用户手册，我和一位同事讨论过。他说我不能在手册的任何地方使用“你”这个词。现在我在学校记得这件事，但这不是写作程序。此外，做一些谷歌搜索我观察到大多数教程使用它很多。我更喜欢使用它，但只有这被认为是一种好的做法。你觉得怎么样？

Answer 1

有些人认为手册应该写成科学论文。其他人认为技术准确性和可读性更重要。我是后者的说服力 - 如果它符合你的整体风格，请使用“你”，但要保持一致 - 我发现在“你”和“我们”之间切换的文件很烦人（这是我犯的罪我自己犯了罪。

Answer 2

我所知道的替代方案是：

• '你'（第二人称单数） - “你应该将盘子放在桌子上。”
• 势在必行 - “把盘子放在桌子上。”
• '我们'（第一人称复数） - “我们应该将盘子放在桌子上。”
• '用户'（第三人称单数） - “用户应将盘子放在桌子上。”
• 被动 - “盘子应放在桌子上。”

我自己的偏好是：

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

Answer 3

哪个更容易理解？

  

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

或

  

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

第一个更容易掌握。 （使用“你”有时可能是草率的，但往往是在用它来代替“一个”，或“某些人”或“一般人”的情况下。在你实际使用它的地方很好指阅读文本的人。）

Answer 4

你应该写第三人的解释。

  

Java流模型是一个经典的Decorator模式示例。

你应该写第二个人的指示，但即便如此，将读者称为“你”仍然不是一个好主意。

  

根据给定的列表列表创建一个可以初始化列表的构造函数。

现在，在我向你发出2个命令之后，你的感受如何？

Answer 5

• 如果你想要，你可以避免 你写的风格 被动/命令式。您可以 也尝试'我们'的方法，但那 可能听起来有点孩子气。你是 使用你没有错 虽然。
• 为了避免以自己的方式写作， 使用被动/命令式风格。该 不过，我们接近可能也工作 听起来有点幼稚。那里 使用你是没有错的 虽然。
• 我们可以避免以你的风格写作 通过采用被动/命令 样式。或者我们可以使用 我们接近，虽然我们可能听起来像 有点孩子气。人们可以尝试一个 方法，但风险听起来 僵硬的上唇和疏远的 读者。 我们不介意一次使用你 不过，有一段时间。

我自己更喜欢第二行。一系列命令更容易遵循你的形式的故事。

Answer 6

技术写作强制执行仅使用被动文本的规则。这意味着避免“你”将是一个保持安全的好主意。这是基于我个人的表现。

Answer 7

我认为如果您提供必要条款，例如“打开门”，或直接向读者发送信息，那么您应该使用“您”，而不是通过谈话让自己更难理解关于一些抽象用户。

即使在科学论文中，我能想到的一些最正式的写作，是否允许我，我们和其他第一人称语言仍有争议。尽管高中语法教师可能希望你不这么认为，但没有普遍适用的方案。

Answer 8

我会做谷歌，微软，雅虎等的事情。以下是Google提供的随机帮助页面：

http://mail.google.com/support/bin/answer.py?hl=en&answer=8494

表示正在使用“你”。您也可以查看Microsoft如何编写用户手册。

作为旁注，我不会使用“我”或“我们”。

Answer 9

我会说要小心。它可能会过于随意。如果目标受众是商业性的，我会避免它。但是，如果它是一个家庭用户场景或营销是随意的（想想西南航空公司），我会说它去吧。

不要过度使用。然后它会对读者产生负担。

如何使用它的样本？

Answer 10

这一切都取决于你写作的语气和风格。正式方法不鼓励使用“你”。我个人喜欢 使用简洁，风格和相对非正式的风格。我谨慎地使用“你”这个词。

避免过度使用，如：

当您想要启动应用程序时，您必须输入密码，然后您必须选择要使用的功能。

Answer 11

来自技术写作手册。第8版（第262页）：

  

你可以通过遗漏一些文章（a，an，the），一些代词（你，这些，这些）和一些动词来缩短句子，但是这样的句子可能会导致电报风格并且难以理解。 / p>

所以，我说你可以使用它，但就像Gilbert Le Blanc在评论中所说的那样，写“然后点击按钮”而不是“点击按钮”通常会更好。

Answer 12

非个人形式应该是首选。使用＆＃39;你＆＃39;会太清楚，你的大多数客户会相信你不专业。明确的手册也将减少对售后客户支持的需求，并给公司造成损失。