参与项目协作¶
概述¶
- Fork 项目。
- 向仓库提交一个或多个注释良好且干净的提交。
- 在 Github 的 Web 界面中执行 pull request。
如果是新功能请求，请先不要开始编码。记住要打开一个 issue 来讨论新功能。如果您想向其他人的 pull request 添加代码。还要查看git 技巧集合，这将使您的生活更轻松。
源代码¶
- Armbian 构建框架：armbian/build
- Armbian 配置工具：armbian/configng
- Armbian 文档：armbian/documentation
添加新板卡？¶
目前还没有关于如何向构建脚本添加新板卡甚至整个新板卡系列的详细说明。但是有一些提交/拉取请求提供了如何实现这一点的线索，例如
板卡维护者¶
如果您有兴趣成为维护者，请查看板卡支持规则。然后在此处申请并等待接受。一旦被接受，您将被添加到我们的基础设施中。因此，我们需要额外信息来完成您的注册过程。
要求？
- 您必须能够访问您申请维护的硬件
- 您必须有一个应在文档中列出的 Github ID
- 您必须有一个论坛账户
- 您必须有一个 Jira 账户并跟踪为您的板卡提交的问题
- 您必须确保 Armbian 管理 已被告知上述所有 ID 以用于我们的文档
- 您应该了解 Armbian 基础知识，例如如何在您的硬件上运行 Armbian 镜像并进行基本调试，最好通过串口控制台
- 开发、编写代码等方面的知识是可选的，但欢迎
期望¶
维护者不一定必须是有开发经验的人员。他们充当最终用户和开发团队之间的交集，并以最佳努力为开发人员服务。鼓励他们回答基本/简单的用户问题（如果可能，也是最佳努力），而不必打扰开发团队。他们被允许记录错误，但不允许升级错误。团队负责人可以。
请注意，开发团队仍然可以自行决定关注什么，因为 Armbian 必须仔细计划如何花费其非常有限的资源。
- 您必须参与发布过程。理想情况下，您参加与发布相关的会议。在这种情况下，您有机会指出您的板卡的关键问题。
- 您必须在发布过程中签署确认设备已测试、稳定并准备好发布。这基本上意味着您测试正在准备发布的镜像 https://rsync.armbian.com/incoming/
我们在寻找什么？
- 板卡是否启动到 CLI 和 Desktop？
- 桌面是否可用？
- USB 是否工作？（完全或部分）
- 其他功能，如无线、音频
如果某些功能不工作，这是正常和可以接受的。重要的部分是它被记录并且我们收到有关问题的通知。已知问题应放在 Jira 票证中，并将链接放在板卡下载页面上。虽然不是必需的，但您应该设置构建环境，以便您可以立即使用最新的镜像构建镜像并测试它们。您的反馈，无论是正面的还是负面的，都非常欢迎。您可以自由地向每个提交和拉取请求添加评论。
理想情况下，您有多张 microSD 卡可以测试当前发布和夜间版本的常规更新，而不必每次都重新刷新同一张卡以在不同分支之间切换。
或者，您可以使用自动构建的镜像 - 它们位于每个板卡下载页面的最末尾，在”滚动发布”下。
- 您必须在论坛中提供”最佳努力”支持。不要让这个措辞吓到您。这不是一项复杂的任务。关于论坛，这可能包括回答明显的问题（例如，通过指向我们的文档，最好直接指向解决方案页面），让提问者知道需要额外信息以进行进一步调试（例如，请求 “armbianmonitor -u” 输出）或对于升级问题，询问他们是否可以使用来自以下位置的新的未接触镜像重新创建问题：https://www.armbian.com/download/
- 您必须在 Jira 中提供”最佳努力”支持。审查 Armbian 贡献者为您的板卡提交的问题
发布管理员¶
此角色具有允许准备用于发布的镜像的额外权限。
发布管理员： https://github.com/orgs/armbian/teams/release-manager