maint/docs/RELEASE_PROCEDURE

   1 # ---------------------------------------------------------------------------------------
   2
   3 Scenario #1
   4 As developer
   5 I Want To prepare release files for review by developers
   6
   7 Given have latest version from 'git tag' output (saved to ${last_version})
   8   and latest version is increased (saved to ${next_version})
   9
  10 When I want To: prepare to release
  11
  12 Then I Should: sync PO translations from Transifex.net
  13           and sync mc.hint translations from Transifex.net
  14           and create new NEWS wiki page for ${next_version} with empty template
  15           and add content of NEWS-${last_version} wiki page to the doc/NEWS file in git repo
  16           and create new tag '${next_version}' in git
  17           and add new version '${last_version}' in Trac
  18           and add new milestone '${next_version}' in Trac
  19           and create tar.(bz2|xz) package files
  20           and create checksums for archives:
  21           and upload source packages and checksums to the special upload area
  22
  23 # ---------------------------------------------------------------------------------------
  24
  25 Scenario #2
  26 As developer
  27 I Want To review files prepared for release
  28
  29 Given have prepared files for review
  30
  31 When I Want To: release next version
  32
  33 Then I Should: download archives from special upload area
  34            and download checksums for archives from special upload area
  35            and verify checksums and archives
  36            and unpack arhives
  37            and configure with default parameters
  38            and run 'make all install DESTDIR=/tmp/mc-release'
  39            and if everything is okay, keep vote in release ticket
  40
  41 # ---------------------------------------------------------------------------------------
  42
  43 Scenario #3
  44 As developer
  45 I Want To complete the release procedure
  46
  47 Given have votes from developers
  48
  49 When I Want To: complete the release
  50
  51 Then I Should: upload source packages and checksums to http://www.midnight-commander.org/downloads
  52            and update Wiki start page with ${next_version} release number
  53            and write an announcement in mc-dev and mc-users mailists: list user visible changes (bugs and features)
  54            and close  milestone with '${last_version}' version
  55            and create new ticket (type=task, component=adm) for the next release
  56            and close ticket for release.
  57
  58 # ---------------------------------------------------------------------------------------