slachiewicz commented on code in PR #1639: URL: https://github.com/apache/maven-site/pull/1639#discussion_r3744012257
########## content/markdown/developers/retirement-plan-plugins.md: ########## @@ -100,18 +100,27 @@ If the vote passes, make one final release of the plugin (with its own standard ## Step 3: Clean up after the release -1. Remove the `.Jenkinsfile` from all branches. This will remove the project from https://builds.apache.org/job/maven-box/ +Everything that changes the repository has to be merged **before** INFRA archives it. An archived repository is read only, so anything left behind is frozen there permanently, and correcting it costs an unarchive/fix/re-archive round trip. + +1. Remove the `Jenkinsfile` from all branches. This will remove the project from the `maven-box` folder on https://ci-maven.apache.org/job/Maven/job/maven-box/ 2. Remove the `.github` directory from default branch. This will remove GitHub Actions -3. Add " (RETIRED)" at the end of the project name in GitHub by updating `.asf.yaml` -4. Ask INFRA to archive git repos (gitbox + github) -5. When relevant update summary pages for [plugins](https://maven.apache.org/plugins/index.html) or [shared components](https://maven.apache.org/shared/index.html) -6. Comment the [dist-tool configuration](https://ci-maven.apache.org/job/Maven/job/maven-box/job/maven-dist-tool/job/master/site/dist-tool.conf.html) entry. Also comment the plugin's entry in the `GetPrerequisites.java` and `ListBranchesReport` files. -7. Remove from `Source Repository` + 1. Deleting the directory stops new runs but leaves the old ones and their caches behind. Delete the workflow run history and the Actions caches as well, since they are frozen with the rest of the repository and serve no purpose once nothing can run again. +3. Delete stale topic branches. Whatever survives is frozen by the archive, and a branch that still carries a `Jenkinsfile` can keep a build job alive. +4. Update `.asf.yaml`: + 1. Add " (RETIRED)" at the end of the project name. + 2. Point `homepage` at https://maven.apache.org/ rather than the plugin's own site, which moves to the archive along with the plugin. Note that asfyaml only applies a homepage when one is given: removing the key stops it being reasserted but does not clear what GitHub already stores. + 3. Remove `autolink_jira`. This stops the file claiming a Jira project that is being archived, though it does not delete autolinks GitHub has already created — ask INFRA for that. + 4. Leave `features.issues` enabled. An archived repository keeps its issues readable, so disabling the feature would hide every report, including any migrated out of Jira. +5. Replace the `README` with a short retirement notice. The file is otherwise a guide to forking the repository and opening pull requests, which is not actionable on a retired plugin. Keep it to what a visitor needs: that the plugin is retired, the last released version, and a link to the [mailing lists](https://maven.apache.org/mailing-lists.html) for questions. Do not link the plugin's own site, which will not outlive the plugin. Review Comment: Documentation stays on original location but is simply outdated - like for m-stage-p it's build on top of very very old skin that doesn't look too good now -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
