Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
docs:guide-developer:releases:release-process [2020/01/10 14:22] – ↷ Page moved and renamed from inbox:release_process_test to docs:guide-developer:releases:release-process zorundocs:guide-developer:releases:release-process [2023/10/19 04:32] (current) – Add a GitHub release step ynezz
Line 1: Line 1:
-====== High-level process for releases ======+====== High-level release process ======
  
-The goal of this high-level process is to identify what needs to be done for a release, and who can help making it happen. TODO: add links to documentation for each task.+The goal of this high-level process is to identify what needs to be done for a release, and who can help making it happen.
  
 This process applies to both major releases (e.g. 18.06, 19.07) and point releases (e.g. 18.06.5), except for the first part. This process applies to both major releases (e.g. 18.06, 19.07) and point releases (e.g. 18.06.5), except for the first part.
Line 11: Line 11:
 | Decide when to branch | - | Developers consensus | | Decide when to branch | - | Developers consensus |
 | Create release branches | 1 hour | Developer with access to all repositories | | Create release branches | 1 hour | Developer with access to all repositories |
 +| Create a new signing key | 1 hour | Developers |
 | Start building the new branch | 1 hour | Developer with access to buildbot | | Start building the new branch | 1 hour | Developer with access to buildbot |
-| Add new "Reported Version" to https://bugs.openwrt.org | ? | Bugtracker admin |+| Add //release/<version>// label to GitHub issues | ? | GitHub repository access |
 | Fix build issues in the new branch | weeks | All developers | | Fix build issues in the new branch | weeks | All developers |
 || ||
Line 19: Line 20:
 | Identify release blockers | - | ? | | Identify release blockers | - | ? |
 | Fix release blockers | - | All developers | | Fix release blockers | - | All developers |
-| [[docs:guide-developer:making-service-release#prepare_release_tag|Tag new version]] | 15 min | Developer with access to secret keys | +| [[docs:guide-developer:releases:making-service-release#prepare_release_tag|Tag new version]] | 15 min | Developer with access to secret keys | 
-| [[docs:guide-developer:making-service-release#trigger_builds|Build release images]] | 2 days | Developer with access to buildbot |+| [[docs:guide-developer:releases:making-service-release#trigger_builds|Build release images]] | 2 days | Developer with access to buildbot |
 || ||
-^  **3. Quality assurance**  ^^^+^  **3.1 Quality assurance**  ^^^
 ^ Task      ^ Duration       ^ Who can do it          ^ ^ Task      ^ Duration       ^ Who can do it          ^
 | Monitor buildbot for build failures | 2 days | Anybody | | Monitor buildbot for build failures | 2 days | Anybody |
-| Basic runtime testing of release images | 1 day | Anybody |+| Look for missing images on the download server | 2 days | Anybody | 
 +| Basic runtime testing of a few devices | 2 days | Anybody | 
 +| Generate Docker images for target/SDK/imagebuilders | 1 day | Anybody with access to GitLab OpenWrt organization |
 || ||
-^  **3.bis Documentation**  ^^^+^  **3.2 Documentation**  ^^^
 ^ Task      ^ Duration       ^ Who can do it          ^ ^ Task      ^ Duration       ^ Who can do it          ^
-| [[docs:guide-developer:making-service-release#create_changelogs|Generate detailed changelog]]          | 15 min    | Anybody with wiki rights | 
-| Write release notes                  | 1-2 hours | Anybody with wiki rights | 
 | Document new features in the wiki    | variable  | Anybody                  | | Document new features in the wiki    | variable  | Anybody                  |
 +| [[docs:guide-developer:releases:making-service-release#create_changelogs|Generate detailed changelog]]          | 30 min    | Anybody with wiki rights |
 +| Write release notes                  | 1-2 hours | Anybody with wiki rights |
 || ||
-^  **3.ter Update infrastructure**  ^^^+^  **3.3 Update infrastructure**  ^^^
 ^ Task      ^ Duration       ^ Who can do it          ^ ^ Task      ^ Duration       ^ Who can do it          ^
-| Update stable/oldstable links on https://downloads.openwrt.org/      | 10 min    | Sysadmin | +| Update stable/oldstable links on [[https://downloads.openwrt.org/]]      | 10 min    | Sysadmin | 
-| Make sure the [[:toh:start|ToH]] is working with the new version          | ? | Wiki guru | +| [[wiki:internal:toh_update_to_new_release|Update the ToH to work with the new release]]   | 2h | Wiki admin (with ssh access) | 
-| Update OpenWrt front page through the [[releases:19.07:start|release page]]   | 10 min  | Wiki admin                  |+| [[Update package list]] | ? | Wiki admin (with ssh access) |
 || ||
 ^  **4. Communication**  ^^^ ^  **4. Communication**  ^^^
 ^ Task      ^ Duration       ^ Who can do it          ^ ^ Task      ^ Duration       ^ Who can do it          ^
-| Write and pin an announcement in the forum | 10 min | Anybody | +| Update OpenWrt front page through the [[releases:19.07:start|release page]]   | 10 min  | Wiki admin                  | 
-| Write an announcement to the mailing lists | 10 min | Anybody |+| Write and pin an [[https://forum.openwrt.org/c/announcements/14|announcement in the forum]] | 10 min | Developers, Forum admin | 
 +| Close previous announcement topics and direct users to the new release topic | 5 min | Developers, Forum admin, TL4 forum users | 
 +| Send an announcement email to [[https://lists.openwrt.org/mailman/listinfo/openwrt-devel|openwrt-devel]] and [[https://lists.openwrt.org/mailman/listinfo/openwrt-announce|openwrt-announce]] | 10 min | Anybody |
 | Post an announcement on Twitter | 10 min | Anybody with access to the [[https://twitter.com/openwrth|twitter account]] | | Post an announcement on Twitter | 10 min | Anybody with access to the [[https://twitter.com/openwrth|twitter account]] |
 | Update IRC channel topics | 5 min | IRC admin | | Update IRC channel topics | 5 min | IRC admin |
 +| Update the [[about:history|History]] | 5 min | Anybody with wiki rights |
 +| Update [[https://github.com/openwrt/openwrt/releases|GitHub release]] (check [[https://github.com/openwrt/openwrt/pull/13733|result of PR]]) | 10 min | Anybody having GitHub org account |
 +| [[Update wikidata]] [[https://www.wikidata.org/wiki/Q1140401?uselang=en#P348]] | 5min | Anybody with wikidata rights |
 || ||
 ^  **5. Maintainance**  ^^^ ^  **5. Maintainance**  ^^^
  • Last modified: 2020/01/10 14:22
  • by zorun