Release Process: Difference between revisions

From OpenMW Wiki
Jump to navigation Jump to search
(Created page with "The intention of this page is to document the release process, so that anyone taking over responsibility for this task has a reference for all steps involved. The release man...")
 
(→‎Release process steps: adding suggestion to post to Reddit’s OpenMW sub)
 
(12 intermediate revisions by 4 users not shown)
Line 3: Line 3:
The release manager needs the following in order to complete this process:
The release manager needs the following in order to complete this process:


* Access to the Google Code downloads page https://code.google.com/p/openmw/downloads/list
* Core Member Access to the [https://github.com/OpenMW Github OpenMW organization]
* Access to the OpenMW facebook page https://www.facebook.com/OpenMW
* Access to the [https://www.facebook.com/OpenMW OpenMW facebook page]
* Access to the OpenMW Twitter account https://twitter.com/OpenMW_org
* Access to the [https://twitter.com/OpenMW_org OpenMW Twitter account]
* An account on the OpenMW Wordpress
* An account on the [https://openmw.org OpenMW Wordpress]
* Access to the OpenMW Youtube Account
* Access to the [https://www.youtube.com/user/MrOpenMW OpenMW Youtube Account]
 
The current [[Podcaster]] traditionally produces a video commentary to accompany each release.


== Release process steps ==
== Release process steps ==
Line 13: Line 15:
# The project lead calls for release packages to be built and tested
# The project lead calls for release packages to be built and tested
# Once the release packages have been tested sufficiently, the project lead will call for release, and tag the release on GitHub
# Once the release packages have been tested sufficiently, the project lead will call for release, and tag the release on GitHub
# At this point WeirdSexy usually starts working his magic on a release video
# At this point, the Podcaster begins working on a release video
# The Release Manager then writes the release announcement, using the changelog in the readme.
#* Guidelines for doing this may be found [[Podcaster#Guidelines for Producing Release Commentaries|here]]
# The Release Manager then writes the release announcement, using the changelog in the readme
# The release announcement has the following components:
# The release announcement has the following components:
## An intro paragraph, which summarizes the release and directs readers to the downloads page. Example:<blockquote>The OpenMW team is proud to announce the release of version 0.27.0! Grab it from our Downloads Page for all operating systems. This release brings the first official release of OpenCS, the OpenMW team’s efforts to bring an open source solution for editing content for OpenMW. OpenCS is in an early Alpha state, please take that into consideration when testing! See the full notes below.</blockquote>
## An intro paragraph, which summarizes the release and directs readers to the downloads page. See the [[#Example Summary]]
## A link to the release video, crediting WeirdSexy.
## A link to the release video, crediting the Podcaster
## A list of Known Issues from the release
## A list of critical Known Issues from the release
##* Any un-fixed known issues from the last release are carried over
##* Any un-fixed known critical issues from the last release are carried over
##* Any new known issues found during release testing are added
##* Any new known issues found during development and release testing are added
## A list of changes, taken from the release readme, and rewritten to be understandable by normal users
## A list of changes, taken from the release readme, and rewritten to be understandable by normal users
##* Reference the bug reports on the bug tracker https://bugs.openmw.org/ to understand and rewrite the changelog items
##* Reference the bug reports on the bug tracker https://bugs.openmw.org/ to understand and rewrite the changelog items
# The release announcement is then posted on the forum for approval/edits by the team
# The release announcement is then posted on the forum for approval/edits by the team
# Once the video is done, release packages are built, and release announcement is approved, the Release Manager does the release
# Once the video is done, release packages are built, and release announcement is approved, the Release Manager does the release
# All release packages are uploaded to the Google Code
# A release is made on the Github OpenMW page
# All release packages are uploaded to the Github release
## The Linux binary packages
## The Linux binary packages
## The Windows executable packages
## The Windows executable packages
## The OS X package
## The OS X package
## The release source, which is taken from https://github.com/zinnschlag/openmw/releases and re-packaged to not have a top-level folder, and renamed to match the naming convention of previous source releases
## The release source, which should be automatically included by the Github release system
# The Release Announcement is posted to the Wordpress blog
# The Release Announcement is posted to the Wordpress blog
#* If the youtube video has not been made public yet, make it public on the OpenMW youtube account
#* If the youtube video has not been made public yet, make it public on the OpenMW youtube account
Line 36: Line 40:
# A post is made on the OpenMW facebook announcing the release
# A post is made on the OpenMW facebook announcing the release
#* Do a Picture post, using a screenshot from the release, so that people can re-share the post
#* Do a Picture post, using a screenshot from the release, so that people can re-share the post
#* You can cheat and just screenshot WeirdSexy's video if getting a good screenshot of the release isn't woring
#* You can cheat and just screenshot the release video if getting a good screenshot of the release isn't working
#* Paste the plaintext version of the release announcement as the description of the picture
#* Paste the plaintext version of the release announcement as the description of the picture
# (optional) Post the link to the release announcement news post to:
#* https://reddit.com/r/OpenMW
#* https://reddit.com/r/Morrowind
#* https://reddit.com/r/linux_gaming
# Update the [[Outreach]] page
# Post on the OpenMW forum announcing that the release has been completed
# Post on the OpenMW forum announcing that the release has been completed
== Example Summary ==
The OpenMW team is proud to announce the release of version 0.27.0!
Grab it from our Downloads Page for all operating systems. This release brings the first
official release of OpenCS, the OpenMW team’s efforts to bring an open source solution
for editing content for OpenMW. OpenCS is in an early Alpha state, please take that
into consideration when testing! See the full notes below.

Latest revision as of 15:29, 11 February 2021

The intention of this page is to document the release process, so that anyone taking over responsibility for this task has a reference for all steps involved.

The release manager needs the following in order to complete this process:

The current Podcaster traditionally produces a video commentary to accompany each release.

Release process steps

  1. The project lead calls for release packages to be built and tested
  2. Once the release packages have been tested sufficiently, the project lead will call for release, and tag the release on GitHub
  3. At this point, the Podcaster begins working on a release video
    • Guidelines for doing this may be found here
  4. The Release Manager then writes the release announcement, using the changelog in the readme
  5. The release announcement has the following components:
    1. An intro paragraph, which summarizes the release and directs readers to the downloads page. See the #Example Summary
    2. A link to the release video, crediting the Podcaster
    3. A list of critical Known Issues from the release
      • Any un-fixed known critical issues from the last release are carried over
      • Any new known issues found during development and release testing are added
    4. A list of changes, taken from the release readme, and rewritten to be understandable by normal users
  6. The release announcement is then posted on the forum for approval/edits by the team
  7. Once the video is done, release packages are built, and release announcement is approved, the Release Manager does the release
  8. A release is made on the Github OpenMW page
  9. All release packages are uploaded to the Github release
    1. The Linux binary packages
    2. The Windows executable packages
    3. The OS X package
    4. The release source, which should be automatically included by the Github release system
  10. The Release Announcement is posted to the Wordpress blog
    • If the youtube video has not been made public yet, make it public on the OpenMW youtube account
    • TODO: raevol needs to figure out why he can't embed the youtube video...
  11. A tweet is made on the OpenMW Twitter announcing the release and linking to the website
  12. A post is made on the OpenMW facebook announcing the release
    • Do a Picture post, using a screenshot from the release, so that people can re-share the post
    • You can cheat and just screenshot the release video if getting a good screenshot of the release isn't working
    • Paste the plaintext version of the release announcement as the description of the picture
  13. (optional) Post the link to the release announcement news post to:
  14. Update the Outreach page
  15. Post on the OpenMW forum announcing that the release has been completed

Example Summary

The OpenMW team is proud to announce the release of version 0.27.0!
Grab it from our Downloads Page for all operating systems. This release brings the first
official release of OpenCS, the OpenMW team’s efforts to bring an open source solution
for editing content for OpenMW. OpenCS is in an early Alpha state, please take that
into consideration when testing! See the full notes below.