WebRTC项目贡献者权限获取指南

前言

在参与WebRTC项目开发时，贡献者需要了解不同级别的权限体系。本文将详细介绍如何获取WebRTC项目的两种核心权限：测试任务访问权限和提交者权限。

权限级别概述

WebRTC项目为贡献者设置了两个主要权限级别：

1. 测试任务访问权限：允许贡献者使用WebRTC基础设施为自己的代码变更运行测试
2. 提交者权限：允许直接向WebRTC代码库提交变更，包含测试任务访问权限

获取测试任务访问权限

申请条件

申请测试任务访问权限需要满足以下条件：

• 已向WebRTC代码库贡献约10-20个变更列表(CL)
• 熟悉基本的代码审查流程

申请流程

1. 准备申请材料：

   • 用于贡献的邮箱地址
   • 所有贡献的变更列表清单

2. 提交申请工单：

   • 使用专门的模板创建工单
   • 详细说明申请理由和相关贡献

3. 等待审核：

   • 项目成员将审核申请
   • 通过后权限将被授予
   • 如被拒绝，将获得详细反馈

WebRTC提交者职责

获得提交者权限意味着承担更大的责任，主要包括：

代码质量保证

• 确保代码复杂度适中且功能正确
• 遵循C++最佳实践
• 保持一致的代码格式

项目维护

• 保证充分的测试覆盖率
• 维护类和函数级别的文档
• 完善概念性文档

审查责任

当提交者为变更列表标记"Code Review +1"时，即表示确认该变更符合：

• WebRTC风格指南
• 语言使用规范
• 可测试性要求
• 文档标准

成为WebRTC提交者

准备工作

1. 技术准备：

   • 如主要使用C++，需熟悉以下风格指南：
     • Google C++风格指南
     • Chromium C++风格指南
     • WebRTC特定风格指南

2. 法律准备：

   • 签署并提交贡献者许可协议(CLA)

申请流程

1. 创建工单：

   • 使用指定模板提交成为提交者的申请

2. 选择导师：

   • 从现有提交者中选择熟悉你工作领域的导师
   • 可参考代码库中的OWNERS文件寻找合适人选
   • 也可通过提交者邮件列表寻求帮助

3. 接受指导：

   • 将变更列表提交给导师审查
   • 将审查通过的变更列表附加到申请工单中
   • C++开发者需特别展示代码可读性能力

4. 评审流程：

   • 导师认为你准备就绪后，将向评审团队提交申请
   • 团队有5个工作日进行评审
   • 通过后权限将被授予
   • 如被拒绝，将获得详细改进建议

注意事项

1. 不是所有贡献者都需要成为提交者，临时贡献者可通过现有提交者提交变更

2. 建议长期参与WebRTC开发的贡献者申请提交者权限

3. 提交者应持续关注项目动态和规范更新

通过以上步骤，贡献者可以逐步获得WebRTC项目更高级别的权限，从而更深入地参与项目开发和维护工作。