Wiki source code of Release Plan for version 9.8.1
Version 7.1 by Guillaume Delhumeau on 2017/10/05 12:38
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | {{velocity}} | ||
2 | #set ($object = $doc.getObject("ReleasePlans.ReleasePlanClass")) | ||
3 | #set ($version = $object.getProperty("version").getValue()) | ||
4 | #set ($shortVersion = $stringtool.replace($version, '.', '\.')) | ||
5 | #set ($shortVersion = $stringtool.replaceChars($shortVersion, '-', '')) | ||
6 | #set ($shortVersion = $stringtool.upperCase($shortVersion)) | ||
7 | #set ($shortVersion = $shortVersion.replace('MILESTONE', 'M')) | ||
8 | #set ($releaseNotesWikiLink = "xwiki:ReleaseNotes.Data.XWiki.${shortVersion}") | ||
9 | {{/velocity}} | ||
10 | |||
11 | {{info}} | ||
12 | Use these icons to mark the release progress: (x) not done, (/) done, (!) not done for a good reason (explain reason) | ||
13 | {{/info}} | ||
14 | |||
15 | * (/) [[Verify>>ReleasePlans.ReleasePlanHelp||anchor="HInitialBackwardCompatibilityCheck"]] that the ##xwiki-commons##'s top level POM has a ##xwiki.compatibility.previous.version## property correctly pointing to the latest stable (non-milestone) release and if not, change it. | ||
16 | * Make sure next version exists on [[jira>>https://jira.xwiki.org]] projects (JIRA releases are done automatically in the build): | ||
17 | ** (/) [[Commons JIRA>>https://jira.xwiki.org/plugins/servlet/project-config/XCOMMONS/versions]] | ||
18 | ** (/) [[Rendering JIRA>>https://jira.xwiki.org/plugins/servlet/project-config/XRENDERING/versions]] | ||
19 | ** (/) [[Platform JIRA>>https://jira.xwiki.org/plugins/servlet/project-config/XWIKI/versions]] | ||
20 | ** (/) [Only for 8.4.x] [[Enterprise JIRA>>https://jira.xwiki.org/plugins/servlet/project-config/XE/versions]] | ||
21 | * (/) [[Verify>>ReleasePlanHelp||anchor="HVerifyJIRAissue"]] that there are no {{velocity}}[[open issues on JIRA for version $version>>https://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&jqlQuery=Project+in+%28%22XWiki+Commons%22%2C+%22XWiki+Rendering%22%2C+%22XWiki+Platform%22%2C+%22XWiki+Enterprise%22%29+and+fixVersion+in+%28%22$version%22%29+and+resolution+in+%28%22Unresolved%22%29]]{{/velocity}} and that there are {{velocity}}[[no open Blockers>>https://jira.xwiki.org/issues/?jql=priority%20%3D%20Blocker%20and%20resolution%20%3D%20Unresolved%20and%20category%20%3D%2010000]]{{/velocity}}. | ||
22 | * (/) Verify that no tests are failing [[on the CI Server>>http://ci.xwiki.org]] (or that failures are understood, see [[known flickering tests>>https://jira.xwiki.org/issues/?filter=14240]]). | ||
23 | * (/) Verify that there are no {{velocity}}[[missing documentation for closed JIRA issues for version $version>>https://jira.xwiki.org/issues/?jql=Project%20in%20%28%22XWiki%20Commons%22%2C%20%22XWiki%20Rendering%22%2C%20%22XWiki%20Platform%22%2C%20%22XWiki%20Enterprise%22%29%20and%20fixVersion%20in%20%28%22$version%22%29%20and%20resolution%20in%20%28%22Fixed%22%29%20and%20%28%28Documentation%20is%20EMPTY%29%20or%20%28%22Documentation%20in%20Release%20Notes%22%20is%20EMPTY%29%29]]{{/velocity}} | ||
24 | * (/) Ensure that the {{velocity}}[[Release Notes are complete and nice-looking for version $version>>${releaseNotesWikiLink}]]{{/velocity}} | ||
25 | * (/) Since the release is performed on ##agent-1-1## and since it shares memory with other ##agent1-*## agents, mark as offline [[agent1-1>>http://ci.xwiki.org/computer/agent-1-1/markOffline]], [[agent1-2>>http://ci.xwiki.org/computer/agent-1-2/markOffline]] and [[agent1-3>>http://ci.xwiki.org/computer/agent-1-3/markOffline]] to avoid using them in the CI. Put as comment {{velocity}}{{code language="none"}}Temporarily marking agent-1-* offline for the release of $version{{/code}}{{/velocity}}. | ||
26 | * (/) [[Log on the release machine>>ReleasePlans.ReleasePlanHelp||anchor="HLogonReleasemachine"]], [[set up your identity>>ReleasePlans.ReleasePlanHelp||anchor="HSetupyouridentity"]], [[update the release scripts>>ReleasePlans.ReleasePlanHelp||anchor="HUpdateReleasescripts"]] and [[set the correct Java version>>dev:ReleasePlans.ReleasePlanHelp||anchor="HConfiguretheJavaVersion"]] | ||
27 | * (!) [[Update translations>>ReleasePlans.ReleasePlanHelp||anchor="HUpdateTranslations"]] | ||
28 | * (x) [[Build the release>>ReleasePlans.ReleasePlanHelp||anchor="HBuildtherelease"]] | ||
29 | * (x) [[Clean up your identity>>ReleasePlans.ReleasePlanHelp||anchor="HCleanupidentity"]] | ||
30 | * (x) Mark ##agent-1-1## online again in the [[ Jenkins admin screen>>http://ci.xwiki.org/computer/agent-1-1/]] (button on the right). | ||
31 | * (x) Publish [[backward compatibility reports>>ReleasePlans.ReleasePlanHelp||anchor="HGenerateBackwardCompatibilityReport"]] in the {{velocity}}[[Release Notes for version $version>>${releaseNotesWikiLink}]]{{/velocity}} | ||
32 | * (x) Publish [[code contributors list>>ReleasePlans.ReleasePlanHelp||anchor="HGenerateCodeContributorslist"]] in the {{velocity}}[[Release Notes for version $version>>${releaseNotesWikiLink}||anchor="HCredits"]]{{/velocity}} | ||
33 | * (x) [[Push distribution files to OW2 and release them>>ReleasePlans.ReleasePlanHelp||anchor="HPushtoOW2"]] | ||
34 | * (x) Force [[rebuild of the Debian repository index>>ReleasePlans.ReleasePlanHelp||anchor="HRebuildDebianDistribution"]] | ||
35 | * (x) Update the [[Download page>>http://www.xwiki.org/xwiki/bin/edit/Download/]] (Use bullets points for the major features to make it easy to read; Update/Bump the LTS if doing a final major version release, i.e. new cycle) | ||
36 | * (x) [[Force extensions update>>ReleasePlans.ReleasePlanHelp||anchor="HForceExtensionsUpdate"]] | ||
37 | * (x) Set the Release date + Release flag in the {{velocity}}[[Release Notes for version $version>>${releaseNotesWikiLink}]]{{/velocity}} by editing with the object editor. | ||
38 | * (x) [[Create blog post on xwiki.org>>ReleasePlans.ReleasePlanHelp||anchor="HBlogpostonxwiki.org"]] | ||
39 | * (x) [[Update the API doc>>platform:DevGuide.API]], including [[Rendering>>rendering:Main.JavaDoc]] | ||
40 | * (x) Update [[Wikipedia (en)>>http://en.wikipedia.org/wiki/XWiki]], [[Wikipedia (fr)>>http://fr.wikipedia.org/wiki/XWiki]] and [[Wikipedia (compare wiki software)>>http://en.wikipedia.org/wiki/Comparison_of_wiki_software]] | ||
41 | * (x) [[Wikimatrix>>http://www.wikimatrix.org/edit/XWiki]] with Ludovic's account | ||
42 | * (x) [[Announcement Mail>>ReleasePlans.ReleasePlanHelp||anchor="HAnnouncementMail"]] and [[Forum Post>>ReleasePlans.ReleasePlanHelp||anchor="HForumAnnouncement"]] | ||
43 | * (x) [[Announce on Twitter>>ReleasePlans.ReleasePlanHelp||anchor="HAnnounceonTwitter"]] with the [[xwikiorg account>>https://twitter.com/xwikiorg/]] | ||
44 | * (x) Update the [[Release Plan page>>ReleasePlans.WebHome||anchor="HNextReleaseManagers"]] to move yourself to the bottom of the list for your next release. | ||
45 | * (x) Ensure that the {{velocity}}[[release date in this Release Plan>>path:$doc.getURL("edit", "editor=object")]]{{/velocity}} corresponds to the date when the release was finished | ||
46 | * (x) Update the release date on the [[Roadmap page>>xwiki:Roadmaps.WebHome]] for non bugfix releases and move the roadmap items to the archive page (for final releases) | ||
47 | * (x) [[Push Commons and Rendering to Maven Central>>ReleasePlans.ReleasePlanHelp||anchor="HPublishtoMavenCentral"]] | ||
48 | * (x) [[Update the XWiki official Docker images>>ReleasePlans.ReleasePlanHelp||anchor="HUpdateDocker"]] |