在 GitHub 上组织开源项目工作流程的 3 个技巧

通过 GitHub 项目看板,为组织您的开源项目的混乱局面带来条理。
452 位读者喜欢这篇文章。
document sending

Opensource.com

管理一个开源项目是一项具有挑战性的工作,并且随着项目的增长,挑战也会增加。最终,一个项目可能需要满足不同的需求并跨越多个存储库。这些问题不是技术性的,但对于扩展技术项目至关重要。 业务流程管理方法(如敏捷和 看板)为混乱局面带来了条理。开发人员和管理人员可以通过有组织的开发重点,为估计截止日期和团队带宽做出切合实际的决策。

联合国儿童基金会创新办公室,我们使用 GitHub 项目看板来组织 MagicBox 项目的开发。 MagicBox 是一个全栈应用程序和开源平台,用于服务和可视化数据,以便在人道主义危机和紧急情况下进行决策。该项目跨越多个 GitHub 存储库,并与多位开发人员合作。借助 GitHub 项目看板,我们可以在多个存储库中组织我们的工作,以便更好地了解开发重点和团队带宽。

以下是联合国儿童基金会创新办公室关于如何使用 GitHub 上内置的项目看板来组织您的开源项目的三个技巧。

1. 将开发讨论带到问题和拉取请求中

透明度是开源社区的关键组成部分。在规划项目的新功能或里程碑时,社区需要看到并理解一项决策或为什么选择特定方向。为功能和里程碑提交新的 GitHub 问题是让人们了解项目方向的简便方法。 GitHub 问题和拉取请求是项目看板的卡片(或构建块)。要成功使用 GitHub 项目看板,您需要使用问题和拉取请求。

GitHub issues for magicbox-maps, MagicBox's front-end application

opensource.com

联合国儿童基金会 MagicBox 团队使用 GitHub 问题来跟踪正在进行的开发里程碑和其他需要重新访问的任务。团队为开发目标、功能请求或错误提交新的 GitHub 问题。这些目标或功能可能来自外部利益相关者或社区。我们还将问题用作讨论这些任务的场所。这使得将来可以轻松交叉引用,并可视化我们项目之一的即将到来的工作。

一旦您开始使用 GitHub 问题和拉取请求作为讨论和使用项目的方式,使用项目看板进行组织就会变得更容易。

2. 设置看板式项目看板

GitHub 问题和拉取请求是第一步。在您开始使用它们之后,可能很难可视化哪些工作正在进行中,哪些工作尚未开始。 GitHub 的项目看板为您提供了一个平台,可以将卡片可视化并组织到不同的列中。

有两种类型的项目看板可用

  • 存储库:用于单个存储库的看板
  • 组织:用于 GitHub 组织中跨多个存储库的看板(但组织成员私有)

您做出的选择取决于项目的结构和规模。联合国儿童基金会 MagicBox 团队在组织级别使用看板进行开发和文档编制,然后在存储库级别使用特定看板进行重点工作(例如我们的 社区管理看板)。

创建您的第一个看板

项目看板位于您的 GitHub 组织页面或特定存储库上。您将在与问题拉取请求相同的行中看到项目选项卡。在页面上,您将看到一个绿色按钮来创建新项目。

在那里,您可以设置项目的名称和描述。您还可以选择模板来为您的看板设置基本列和排序。目前,唯一的选项是看板式看板。

Creating a new GitHub project board.

opensource.com

创建项目看板后,您可以根据需要对其进行调整。您可以创建新列,设置自动化,并将预先存在的 GitHub 问题和拉取请求添加到项目看板中。

您可能会注意到每个 GitHub 问题和拉取请求中元数据的新选项。在问题或拉取请求内部,您可以将其添加到项目看板。如果您使用自动化,它将自动进入您配置的列。

3. 将项目看板构建到您的工作流程中

在您设置项目看板并使用问题和拉取请求填充它之后,您需要将其集成到您的工作流程中。项目看板只有在积极使用时才有效。联合国儿童基金会 MagicBox 团队使用项目看板作为跟踪我们团队进度、向外部利益相关者更新开发情况以及估计团队带宽以实现我们的里程碑的方式。

Tracking progress

opensource.com

如果您是一个开源项目和社区,请考虑在以开发为重点的会议中使用项目看板。它还有助于提醒您和其他核心贡献者每天花五分钟更新进度(如果需要)。如果您是一家公司,使用 GitHub 进行开源工作,请考虑使用项目看板来更新其他团队成员并鼓励在 GitHub 问题和拉取请求中参与。

一旦您开始使用项目看板,您的看板可能看起来像这样

Development progress board

opensource.com

开放替代方案

GitHub 项目看板要求您的项目在 GitHub 上才能利用此功能。虽然 GitHub 是开源项目的流行存储库,但它本身不是一个开源平台。幸运的是,有一些 GitHub 的开源替代方案,它们提供了复制上述工作流程的工具。 GitLab 问题看板Taiga 是提供类似功能的不错的替代方案。

前进并组织起来!

借助这些工具,您可以为组织您的开源项目的混乱局面带来条理。使用 GitHub 项目看板的这三个技巧鼓励您的开源项目的透明度,并使在开放环境中跟踪进度和里程碑变得更容易。

您是否为您的开源项目使用 GitHub 项目看板?是否有本文未提及的成功技巧?请在下面留言分享您如何理解您的开源项目。

标签
A close-up portrait of a smiling white man with short dark hair and a neatly trimmed beard. He is wearing a red fedora hat, a blue shirt, and a blue lanyard with the word "Fedora" printed on it. The background is blurred, suggesting he is indoors.
Justin W. Wheeler 是一位富有创造力的创作者。他最出名的是一位开源贡献者和自由文化倡导者,最初来自美国佐治亚州。 Justin 参与了众多开源社区,并领导了不同的倡议,以构建可持续的软件和社区超过十年。

评论已关闭。

Creative Commons 许可协议本作品根据知识共享署名-相同方式共享 4.0 国际许可协议获得许可。
© . All rights reserved.