# 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 成员。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://book.bsdcn.org/wen-zhang/wen-zhang/port-dao-shi-zhi-nan.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.