Documentation/devel/release-work.itexi

   1 @c -*- coding: us-ascii; mode: texinfo; -*-
   2 @node Release work
   3 @chapter Release work
   4
   5 @menu
   6 * Development phases::
   7 * Minor release checklist::
   8 * Major release checklist::
   9 @end menu
  10
  11
  12 @node Development phases
  13 @section Development phases
  14
  15 There are 2.5 states of development for LilyPond.
  16
  17 @itemize
  18
  19 @item @strong{Stable phase}:
  20 Starting from the release of a new major version @code{2.x.0}, the
  21 following patches @strong{MAY NOT} be merged with master:
  22
  23 @itemize
  24 @item Any change to the input syntax.  If a file compiled with a
  25 previous @code{2.x} version, then it must compile in the new
  26 version.
  27
  28 @item New features with new syntax @emph{may be committed},
  29 although once committed that syntax cannot change during the
  30 remainder of the stable phase.
  31
  32 @item Any change to the build dependencies (including programming
  33 libraries, documentation process programs, or python modules used
  34 in the buildscripts).  If a contributor could compile a previous
  35 lilypond @code{2.x}, then he must be able to compile the new
  36 version.
  37
  38 @end itemize
  39
  40 @item @strong{Development phase}:
  41 Any commits are fine.  Readers may be familiar with the term
  42 @qq{merge window} from following Linux kernel news.
  43
  44
  45 @item @strong{Release prep phase}:
  46 FIXME: I don't like that name.
  47
  48 A new git branch @code{stable/2.x} is created, and a major release
  49 is made in two weeks.
  50
  51 @itemize
  52
  53 @item @code{stable/2.x branch}:
  54 Only translation updates and important bugfixes are allows.
  55
  56 @item @code{master}:
  57 Normal @qq{stable phase} development occurs.
  58
  59 @end itemize
  60
  61 If we discover the need to change the syntax or build system, we
  62 will apply it and re-start the release prep phase.
  63
  64 @end itemize
  65
  66 This marks a radical change from previous practice in LilyPond.
  67 However, this setup is not intended to slow development -- as a
  68 rule of thumb, the next development phase will start within a
  69 month of somebody wanting to commit something which is not
  70 permitted during the stable phase.
  71
  72
  73
  74 @node Minor release checklist
  75 @section Minor release checklist
  76
  77 A @qq{minor release} means an update of @code{y} in @code{2.x.y}.
  78
  79 email brief summary to info-lilypond
  80
  81
  82
  83 @node Major release checklist
  84 @section Major release checklist
  85
  86 A @qq{major release} means an update of @code{x} in @code{2.x.0}.
  87
  88 Before release:
  89
  90 * write release notes. note: stringent size requirements for
  91  various websites, so be brief.
  92
  93 * write preface section for manual.
  94
  95 * submit pots for translation : send url of tarball to
  96 translation@@iro.umontreal.ca, mentioning lilypond-VERSION.pot
  97
  98 * Check reg test
  99
 100 * Check all 2ly scripts.
 101
 102 * Run convert-ly on all files, bump parser minimum version.
 103
 104 * Make FTP directories on lilypond.org
 105
 106 * website:
 107   - Make new table in download.html
 108
 109   - add to documentation list
 110
 111   - revise examples tour.html/howto.html
 112
 113   - add to front-page quick links
 114
 115   - change all links to the stable documentation
 116
 117   - doc auto redirects  to v2.LATEST-STABLE
 118
 119 News:
 120
 121         comp.music.research
 122         comp.os.linux.announce
 123
 124         comp.text.tex
 125         rec.music.compose
 126
 127 Mail:
 128
 129         info-lilypond@@gnu.org
 130
 131 linux-audio-announce@@lists.linuxaudio.org
 132 linux-audio-user@@lists.linuxaudio.org
 133 linux-audio-dev@@lists.linuxaudio.org
 134
 135         tex-music@@icking-music-archive.org
 136
 137    --- non-existant?
 138         abcusers@@blackmill.net
 139
 140         rosegarden-user@@lists.sourceforge.net
 141         info-gnu@@gnu.org
 142         noteedit-user@@berlios.de
 143
 144         gmane.comp.audio.fomus.devel
 145         gmane.linux.audio.users
 146         gmane.linux.audio.announce
 147         gmane.comp.audio.rosegarden.devel
 148
 149 Web:
 150
 151         lilypond.org
 152         freshmeat.net
 153         linuxfr.com
 154         http://www.apple.com/downloads
 155         harmony-central.com (news@@harmony-central.com)
 156         versiontracker.com [auto]
 157         hitsquad.com [auto]
 158         http://www.svgx.org
 159
 160
 161
 162