新开发者/沟通技巧

这些技巧能让你有效地与他人沟通，得到社区中其他成员的帮助。

高效率地使用Phabricator任务

当您准备着手处理一个Phabricator任务时：

• 无需请求许可： 您无需请求任何人将任务分配给您即可开始进行任务。 不存在谁能分配任务或是需要先问谁的权威人士。
  • 如果一个任务在Gerrit中已经有了一个最近的补丁，请选择一个不同的任务作為替代。
  • 如果Gerrit中的一个现有补丁還没有被合并，而且很长时间都没有任何改动，你可以根据Gerrit裏和任务裏的反馈，改进那個现有补丁。
• 自行研究： 当您考虑进行某个任务时，在开始敲代码前先研究一番。仔細看看代码，試著去理解这些代码本该达到什么目的，閱讀相關的文件，然后尽量找到应该作出修改的地方。
  • 在一個Phabricator 任务中，使用侧边栏中的项目标签，找到任务的代码库。
  • 如果您对修复某个漏洞的办法毫无头绪，考虑先找个更简单的。
• 你不需要在开始工作之前宣佈你的计划，但你应该传达你正在进行的任务。
  • 当你开始工作时，通过点击Phabricator中的「编辑任务...」将自己设置为任务分配人，并在「分配给」字段中设置你的Phabricator用户名。 这就向其他人传达了你正在工作，所以他们不会重复工作。
  • 当你的计划或兴趣改变时： 如果你不再从事某项工作，请将你自己作为该任务的分配人删除。 这告诉其他人，他们可以从事这项工作，而他们不会期望你仍然在从事这项工作。
• 遵守Phabricator礼仪.
  • 在Phabricator任务中，只讨论有关该任务主题的具体问题。 別拿Phabricator来问一般的问题，比如如何建立一个开发环境或如何修复Gerrit的问题。

撰写好的问题

• 不要讓他人還要從你的提問裏面再提問...只要讓他人看你的提問一次就好！。
• 要具体，并提供來龍去脈： 不要只是简单地问：「你能给我更多信息吗？」、「请指导我」、或「请告诉我如何开始」，而是在你的问题中包括以下信息：
  • 你想要达到什么？
  • 你已經試過什麼？ 复制和粘贴你的命令和它们的输出（如果不是太长），而不是用你自己的话进行转述。
  • 在你的研究中，你已经发现了什么？ 包括代码的链接、文档的链接、或其他你已经咨询过的资源的链接。
• 在你的通信中使用具体的标题和主题行。 「提案的草案」或「我需要帮助」并不具体。
• 保持对话的可读性： 当你在Zulip、Phabricator任务或邮件列表中回复时，只引用与你的回复相关的先前评论部分。 如果你引用一整個「完整的」以前的评论，它使线程难以阅读。

遵循沟通政策與最佳做法

在你发送或张贴你的问题之前：

• 阅读并遵守维基媒体技术空间行为守则。
• 使用inclusive language : 不要使用假定性别身份的字眼（如「兄弟」、「夫人」或「先生」），而是應該使用人的姓名。

在正确的地方提问

• 公开询问：如果你谈话的主题不是什麼秘密，就不要发送私人信息。 私人信息对他人没有作用。
• 在最好的地方提问和讨论：
  • 在Phabricator任务中，只讨论有关该任务主题的具体问题。
  • 在联系交流 列出的地方裏面询问一般的技术问题，例如：如何建立一个开发环境或如何解决Gerrit的问题。
  • 如果你参加了拓展计划，那么Zulip是用来讨论关于拓展计划本身的问题。

请耐心等待

在你发布你的问题之后：

• 不要在单独的信息中要求别人进行代码审查。 人们会收到Gerrit和Phabricator的通知，并会在他们可以的时候做出回应。
• 在征求意见和评论时，特别是在周末和节假日，你可能需要等到恢复工作时间。 在像IRC这样的聊天频道中：如果没有人回答，在不同的时间再试一次；別这样就放弃了。
• 如果你在等待和耐心等待之后仍然没有得到答案，请考虑其他沟通渠道是否是一个更好的地方来提出你的问题。