Skip to content

代码所有者#

Autoware 项目使用多个 CODEOWNERS 文件来指定整个存储库的所有者.有关代码所有者的详细信息,请访问 关于代码所有者的 GitHub 文档.

CODEOWNERS 文件的目的和功能#

CODEOWNERS 文件在管理拉取请求 (PR) 方面发挥着至关重要的作用：

  • 自动化审核请求：自动将 PR 分配给负责的个人或团队.
  • 强制合并批准：防止未经指定代码所有者或仓库维护者批准而进行 PR 合并,确保彻底审查.
  • 维护质量控制：通过要求知识渊博的个人或团队进行审查,帮助保持代码质量和一致性.

查找 CODEOWNERS 文件#

CODEOWNERS 文件位于 Autoware 项目的多个存储库的 .github 目录中.autoware.repos file 列出了这些仓库和它们的目录.

维护 CODEOWNERS#

通常,仓库维护员会处理对 CODEOWNERS 文件的更新.要提出更改建议,请提交 PR 以修改文件.

Autoware Universe 存储库的特殊情况#

在 autoware_universe 存储库中, CODEOWNERS 文件的维护由 CI 自动进行.

此工作流程 根据存储库中软件包的 package.xml 文件中的 maintainer 信息更新 CODEOWNERS 文件.

要更改 autoware_universe 存储库中软件包的代码所有者：

  1. 通过 PR 修改 package.xml 文件中的 maintainer 信息.
  2. 合并后,CI 工作流将在 UTC 午夜运行(或可由维护者手动触发)以更新 CODEOWNERS 文件并创建 PR.
  3. 然后,维护者需要合并 CI 生成的 PR 以完成更新.

代码所有者的责任#

代码所有者应及时查看分配的 PR. 如果 PR 在一周内仍未审核,维护者可能会介入审核并可能合并它.

常见问题#

未审核的拉取请求#

如果您的 PR 尚未被审核：

  • 🏹 直接地址代码所有者：在 PR 上发表评论以提醒所有者.
  • ⏳ 一周后跟进：如果一周后未审核,请在 PR 下添加评论并标记 @autoware维护者 .
  • 📢 如有必要,请升级：如果您的请求仍然未得到回应,您可以通过在 Autoware Discord 频道 🚨 中.请记住,维护者经常要兼顾许多责任,因此耐心是值得赞赏🙇的.

PR 作者是唯一的代码所有者#

如果您作为唯一的代码所有者创作了 PR：

  • 通过标记 @autoware-maintainers 来请求审核.
  • 维护者将考虑任命额外的维护者以避免此类冲突.

非代码所有者审查 PR#

任何人都可以查看 PR：

  • 您可以查看任何拉取请求并提供您的反馈.
  • 您的审查可能不足以合并拉取请求,但它会帮助代码所有者和维护者做出决定.
  • 如果您认为拉取请求已准备好合并,您可以在拉取请求的评论中提及代码所有者和维护者.