插件的退休计划
决定退休
提议对开发列表进行投票以淘汰插件。投票应在标准的 72 小时内开放,以便人们发表意见。向用户列表发送 cc。适用标准 Apache 投票规则。只有 PMC 投票具有约束力。
投票必须包含一个或多个关于如何停用插件的选项。有多种方案可用。这里有几个建议:
- 在 svn 中移动到我们的退休区
- 移动到另一个 Apache 项目
- 移至 www.mojohaus.org、apache-extras.org 或其他伪造
这是可用于投票电子邮件的方案 A 的模板:
To: "Maven Developers List" <dev@maven.apache.org> Cc: "Maven Users List" <users@maven.apache.org> Subject: [VOTE] Retire Maven Foo Plugin Hi, A paragraph giving the reasons why the plugin should be retired. Make a note of how long it has been since the latest release. I therefore propose that we retire maven-foo-plugin. If this vote is successful I will make one final release of the plugin, making it clear on the plugin site that it has been retired. After that the source code will be moved into the "retired" area in Subversion. The process for retiring a plugin is described here: https://maven.apache.org/developers/retirement-plan-plugins.html The vote is open for 72 hours. [ ] +1 Yes, it's about time [ ] -1 No, because...
如果投票成功,将结果发布到开发列表并抄送 PMC 和用户列表。例如:
To: "Maven Developers List" <dev@maven.apache.org> Cc: "Maven Users List" <users@maven.apache.org> CC: "Maven Project Management Committee List" <private@maven.apache.org> Subject: [RESULT] [VOTE] Retire Maven Foo Plugin Hi, The vote has passed with the following result: +1 (binding): <<list of names>> +1 (non binding): <<list of names>> I will continue with the steps required to retire this plugin.
如果投票通过,请在插件退役之前进行一次最终版本的插件发布(对源代码发布有自己的标准 72 小时投票)。这使我们能够彻底决裂。想要退出插件的人是最终发布的人。除了我们的标准发布流程之外,您将在下面找到停用插件时需要遵循的额外步骤。
制作最终版本
- 在 JIRA 中创建问题类型为“任务”和摘要“停用此插件”的问题,并将其安排到最终版本。如果插件在生成的站点中包含 JIRA 报告,则需要在发布之前关闭此问题。
- 添加描述“这是这个插件的最终版本。它已经退役了。” 到 JIRA 中的最终版本。
- 在插件站点的首页添加一个醒目的通知,通知该插件已停用。建议文字:
Note: This plugin is retired. It is no longer maintained.
如果插件被移到其他地方,那也应该被添加到插件的站点中。建议文字:
Note: This plugin has retired from the Apache Maven project, but has moved to the <Organization> <Project> project.
- 在插件的
<project>
. 这将显示在生成的站点的每个页面上。<name>
pom.xml
- 继续执行标准发布流程,确保您遵循上述有关站点部署的例外情况。
- 更新插件页面时,将 Maven Foo Plugin 移动到“Retired”标题下。删除 SVN 和 JIRA 链接并添加停用日期。
- 在 JIRA 中更新版本时,不要添加 Y.Z+1 并确保删除任何未来版本。
发布后清理
.Jenkinsfile
从所有分支中删除。这将从 https://builds.apache.org/job/maven-box/ 中删除该项目- 向 INFRA 询问存档 git repos (gitbox + github)
- 重新发布文档,项目名称后缀为 (RETIRED)
- 当插件或共享组件的相关更新摘要页面
- 在 JIRA 中的项目名称末尾添加“(RETIRED)”。
- 如果是独立项目(拥有 Jira 密钥),请将 JIRA 项目置于只读模式:应用 Maven 退休项目权限方案。(需要 JIRA 管理员业力:例如询问 Brian Fox)
- 注释dist-tool 配置条目。
- 从当前dist 区域中删除分布(历史仍然在存档中可用)。
- 更新董事会报告
- 在announce@mao 和users@mao 邮件列表中宣布该插件已停用/移动。向人们解释如果他们想继续开发插件应该做什么。