跳至主要内容
The Apache Software Foundation
Apache 20th Anniversary Logo

项目主席委员会报告指南

Apache 项目管理委员会 (PMC) **必须** 每季度向董事会报告其项目的健康状况和状态。虽然 PMC 独立管理自己的技术事务,但董事会提供监督,以确保项目继续作为健康、社区驱动和共识驱动的项目运营,以支持我们的使命。另请参阅PMC 职责常见问题解答。PMC 主席和 Apache 成员始终欢迎参加每月董事会会议

目录

何时提交项目董事会报告

**每个 PMC 的主席** 负责每季度提交其项目的报告,至少在每个董事会会议前**一周**提交,具体时间表请参见

https://svn.apache.org/repos/private/committers/board/committee-info.txt

延迟报告或在上述时间表之外报告不会改变此时间表:例如,如果您应该在 1 月份提交报告,但错过了并且在 2 月份提交了报告,那么您的下一份报告仍然在 4 月份到期。如果您未在董事会充分审查报告所需的时间内提交报告,则会要求您在下个月重新提交报告。

虽然在大多数情况下,主席会与其他 PMC 成员合作编写报告,但最终由主席负责完成并提交报告。董事会向主席和 PMC private@ 邮件列表发送多条自动提醒,以帮助您记住此任务。

例外情况:新毕业的 PMC 必须在离开 Apache Incubator 后头三个月内提交每月报告。Apache Incubator 中的所有 Podling 都使用孵化器 Podling 状态流程填写类似的报告。

如何提交项目董事会报告

您必须将报告内容提交到董事会的每月会议议程。
使用 Whimsy 议程工具或 ComDev 项目报告工具,该工具会为您生成一个方便的框架

https://whimsy.apache.org/board/agenda/
https://reporter.apache.org/
  1. 使用您的 Apache ID 登录
  2. 找到您项目的条目,然后点击底部的蓝色发布报告按钮
  3. 在点击提交之前,请确保重新调整报告格式
  4. 如果需要进行更改,您可以在提交报告后对其进行编辑

命令行用户可以自由地检入他们的报告,遵循现有格式,以便自动化工具可以解析它们,此处

  https://svn.apache.org/repos/private/foundation/board/

如果 PMC 有值得注意的事情要报告或需要反馈,董事会欢迎 PMC 在其计划的报告之外提交任何报告。在这种情况下,主席可以将报告作为附件添加到议程末尾,并为其创建相应的评论部分。

虽然报告的主要受众是董事会,但请记住,报告在会议结束后会公开,并提供项目的编年史。最好以您希望社区现在了解的信息编写报告,并以一种对将来查看报告的人员提供有用历史的方式编写。

您可能也希望通过用户列表或项目网站与您的项目社区共享报告的公开部分。

Apache 委员会报告工具可以简化收集报告数据的过程,但您必须编辑并添加从生成的模板中获取的信息,以涵盖以下要点。
提交报告时,请勿在报告中保留任何TODO 标记

董事会报告中需要涵盖的要点

这些要点**不是**模板;项目不应简单地将这些要点复制粘贴到其报告中。相反,这些是董事会希望了解的主题,以便能够评估项目的健康状况和状态。并非所有主题都与每个报告相关;但是主席在撰写报告时应考虑每个问题。

报告中应包含的内容

私人信息

偶尔,项目可能需要私下向董事会报告某些内容,但又不希望该信息在公开记录中发布。请记住,所有 Apache 董事会报告都会公开,通常在董事会会议后一两个月。

您的报告中欢迎此类信息,但请将其包含在

<private>

</private>

标记符内,**每行一个**,以便我们知道从公开记录中省略什么。要验证私有标记是否有效,请在 Whimsy 中发布您的报告,然后刷新页面。
正确标记的私有部分以灰色背景显示。

如果问题极其敏感,并且您非常关心隐私,则可以改为直接发送电子邮件至board-private@或某个董事会成员,他们会将信息转达给董事会。

报告的其他注意事项

项目报告是让董事会了解项目状态和健康状况的关键方式。鉴于 Apache 项目的多样性,这些指南无法涵盖所有情况。请随时在您的报告中包含您认为对您的项目很重要的任何其他信息。

特别是,如果 PMC 主席或其他成员在项目中看到任何“问题点”——即使是潜在的——请务必在您的董事会报告中包含一条关于它们的说明。最好在报告中包含您的担忧——或您 PMC 部分成员的担忧——而不是让董事会以后可能发现它们。

最后,如果您发现自己的项目似乎没有足够的活动来创建很多报告,那么请务必报告这一事实。一个健康的项目应该意识到它是否正走向 Apache Attic。迁移到 Attic 并不是失败;它只是认识到项目可能已经成熟、偏离轨道或被其他技术所取代,我们应该认识到这一事实。

董事会依靠项目主席的报告来了解项目的状况和健康状况。如果董事会无法强烈感受到您的项目进展如何,那么我们将在不久的将来联系您以获取后续报告。

参与董事会关于报告的讨论

项目报告不是单向的沟通方式。它们也是与董事会互动的一个机会。项目主席欢迎以嘉宾身份参加董事会会议并讨论他们的报告。他们还可以突出他们希望董事会考虑的具体问题(在报告中或通过要求将更广泛的讨论议题列入议程)。

当然,主席也可以随时利用这个机会在 Board@ 邮件列表中提出任何这些讨论,无论是在其报告期内还是报告期外。

每次您需要提交报告时,都会随机指定一位董事作为您项目报告的“牧羊人”。如果您的报告迟交,他们将负责跟进;如果存在重大意见或缺乏批准,他们将在会议期间描述该报告;并在会议后将任何后续消息或行动传达给您的 PMC。

在会议前,董事们在审查报告时,可能会在您的报告旁边的议程中添加评论。我们鼓励项目主席关注此董事会反馈(目前可以通过监视 SVN 提交或使用Whimsy议程工具),并在实际情况下在会议前回复。

董事会会议通常遵循以下模式

  1. 在月初,创建议程并向本周期需要提交报告的项目发送提醒。
  2. 相关人员在接下来的几周内将报告添加到议程中,直到会议截止日期。
  3. 董事们在方便时审查提交的报告,如果没有任何问题,则将其标记为“预先批准”。他们有时会添加评论或请求更多信息,或编辑内容以进行明显的更正。
  4. 牧羊人接近会议时被分配,并更熟悉这些项目报告。
  5. 在会议前 24 小时内,将报告摘要和任何评论发送到董事会邮件列表。
  6. 在会议期间,董事会主席快速浏览已获得 5 个或更多“预先批准”并且没有重大评论的报告。
  7. 有重大评论、讨论事项或缺乏预先批准的报告将移交给牧羊人,牧羊人将在会议期间促进讨论并推荐任何进一步的行动。
  8. 在董事会会议结束后,会向所有提交者发送一份摘要,让他们了解主要结果。
  9. 任何未获批准或缺失的项目报告将添加到下个月的提醒列表中。
  10. 牧羊人会与项目主席联系,具体说明会议中针对其报告提出的行动项目。
  11. 会议结束后不久,秘书会将董事们对您报告的任何评论发送到您项目的private@列表。这会为您提供会议的简要反馈,并有机会与董事会互动,以回答问题或寻求建议。如果董事会对您的项目有任何疑问,回复所有人并回答它们
  12. 报告在获得董事会下个月会议批准后,作为会议记录的一部分发布。

如您所见,确保我们及时收到您的报告,其中包含所有必要的详细信息,以及您解决任何评论,这极大地提高了董事会会议的流程,董事会每个月需要处理 80 多个项目和子项目的报告,以及其他事务。