用户提交的 ebuild

用户提交的 ebuild 不应被盲目信任,并且在提交到树中之前应始终经过充分测试和审核。 提交用户提交的 ebuild 的开发人员保证该 ebuild 符合所有 Gentoo Linux 开发标准。

用户提交的 ebuild 不得包含这样的自定义标头

# Ebuild updated by: me <[email protected]>

此类信息应包含在 git 提交消息中。 在提交消息中使用 Suggested-By:Reported-By: 等标签,如 提交消息格式部分 中所述,是强烈鼓励的。 请注意,以 git 补丁或拉取请求形式接收的 ebuild 默认情况下将以用户作为提交者,在这种情况下,在提交消息中明确包含用户信息可能不是必需的。 如果情况并非如此,您可能希望使用 git commit 的 --author 参数来明确给予他们荣誉。

开发人员必须检查提供的用户提供的补丁或 Bugzilla 上的评论中是否包含有效的 Signed-off-by 行。 有关详细信息,请参阅 来源证书

应鼓励用户在提交升级时向现有 ebuild 提交差异。 这样做将有助于避免将以前修复的 bug 重新引入“新”ebuild 中。 如果不是从差异而是从完整的用户提交的 ebuild 开始,则应使用 diff -u 命令查看发生了哪些变化; 应注意当前 ebuild 中应出现在新 ebuild 中的任何内容,或新 ebuild 中应修复或删除的任何内容。

一般来说,最好让用户完成使他们的 ebuild 达标所需的工作,以便他们可以从错误中学习并在将来提交更干净的 ebuild。 务必感谢任何提交,即使它不是很好。 礼貌但诚实 - 如果 ebuild 不可使用,可以以不侮辱他们当前的 ebuild 编写能力的方式告诉用户。 请记住,提交该损坏 ebuild 的用户将来可能成为我们项目的熟练且富有成效的成员 - 也就是说,如果他们获得适当的鼓励和支持并继续提高他们的能力。