# Port 导师指南

* 原文：[Port Mentor Guidelines](https://docs.freebsd.org/en/articles/port-mentor-guidelines/)
* 作者：Thomas Abthorpe, Chris Rees

## 1. 导师/学员关系指南

本节旨在帮助解开导师关系的谜团，并作为公开促进建设性讨论的方式，以适应和发展这些指南。在我们的生活中有太多的规则；我们不是个强制执行法规的政府组织，而是由志同道合的人们组成的集体，致力于共同目标，保持我们称之为 Ports 的产品质量保证。

### 1.1. 为什么做导师？

* 对于我们中的大多数人来说，都是在项目中得到了导师的指导，因此回报这个恩惠，向其他人提供指导。
* 你有一种不可抗拒的冲动，想要将知识传授给别人。
* 通常的“惩罚”是因为你已经厌倦了贡献别人做的好工作！

### 1.2. 导师/共同导师

共同导师的理由：

* 显著的时区差异。通过即时通讯可以方便互动的导师非常有帮助！
* 可能存在语言障碍。是的，FreeBSD 主要以英语为主，就像大多数软件开发一样，但是，如果有一个能讲母语的导师，那将非常有用。
* 没有时间！直到有了 30 小时的一天和 8 天的一周，我们中的一些人只能提供有限的时间。与其他人分担负担会更容易。
* 初级导师可以从资深提交者/导师那里获得经验。
* 两个头脑总比一个好。

单独担任导师的理由：

* 你不喜欢与他人合作。
* 你更喜欢一对一的关系。
* 共同导师的理由对你不适用。

### 1.3. 期望

我们期望导师能够审查并测试构建所有提出的补丁，至少在最初的一个多星期或两周内进行。

我们期望导师应对其学员的行为负责。导师应跟进学员所做的所有提交，无论是已批准的还是隐性提交。

我们期望导师确保学员阅读 [Porter’s Handbook](https://docs.freebsd.org/en/books/porters-handbook/)、[PR 处理指南](https://docs.freebsd.org/en/articles/pr-guidelines/) 和 [Committer’s Guide](https://docs.freebsd.org/en/articles/committers-guide/)。虽然没有必要记住所有的细节，但每个提交者都需要了解这些内容，才能有效地成为社区的一部分（并尽量避免犯新手错误）。

### 1.4. 选择学员

没有明确的规则来判断候选人是否准备好；它可以是他们提交的 PR 数量、维护的 Port 数量、Port 更新的频率或在 GNOME、KDE、Gecko 等特定领域的参与程度的组合。

候选人应该几乎没有超时，能够及时回应请求，并且在支持其 Port 上通常是乐于助人的。

必须有一定的参与历史，因为普遍认为培训一名提交者需要时间和精力。如果某人已经在社区里呆了更长时间，并花时间观察事情是如何做的，那么可以预期其积累了一些知识。我们常常看到有的维护者提交了几个 PR，出现在 IRC 上，问什么时候可以获得提交权限。

订阅并关注邮件列表非常有益。没有真正的期望认为在邮件列表上发布帖子会使某人成为提交者，但它展示了参与。有些邮件能提供候选人的知识见解，以及他们如何与他人互动。同样，参与 IRC 也可以让某人提高知名度。

如果你问六个不同的提交者，一个维护者在被提名之前应该提交多少个 PR，你将得到六个不同的答案。如果问这些人应该参与多久，也会是同样的困境。最低应该有多少个 Port？现在我们有“分歧”！有些事情很难量化，导师只能凭借他们的最佳判断，期望 portmgr 同意。

### 1.5. 导师关系的持续时间

随着信任水平的发展，学员可能会被授予“隐性”提交权限。这可以包括对 **Makefile**、**pkg-descr** 等的小修改。同样，它也可以包括不包含 `plist` 更改的 `PORTVERSION` 更新。在导师的酌情决定下，可能会形成其他情况。然而，在导师关系期间，影响依赖 Port 的版本提升应该由导师检查。

正如我们每个人都是不同的个体，每位学员有不同的学习曲线、时间承诺和其他影响因素，这些因素会影响他们何时能够“独立操作”。经验上，学员应该观察至少 3 个月。90-100 次提交是导师可以使用的另一目标，之后可以考虑让学员独立。其他考虑因素包括他们可能犯过的错误、收到的 QAT 等。如果他们仍然犯新手错误，仍然需要导师指导。

### 1.6. 导师/共同导师辩论

当一个请求提交给 portmgr 时，通常是：“我提议将 'foo' 提名为 Port 提交者，我将与 'bar' 一起共同担任导师。” 提案接收、投票并通过。

导师是主要的联络人，或者说是“首席”，共同导师是备用。

有个不愿透露姓名的坏蛋做出了 [第一个记录的共同导师提交](https://lists.freebsd.org/pipermail/cvs-ports/2007-September/134614.html)。类似的共同导师提交也出现在 src 树中。这就意味着对吗？这就意味着错吗？似乎这是事物发展的一部分。

### 1.7. 期望

我们期望学员准备好接受来自社区的建设性批评。社区中仍有许多“经验”，但这些经验并未写下来。我们希望通过首先审查学员在 IRC 和邮件列表上的现有贡献来挑选那些能够很好回应建设性批评的人。

我们警告学员，某些收到的批评可能不那么“建设性”（可能是语言沟通问题，或者过于挑剔），并且优雅地处理这些批评是成为大型社区一员的一部分。如果与某些人有特定问题，或有任何疑问，我们希望学员能够通过 IRC 或电子邮件联系 portmgr 成员。