Skip to content

MapServer 6.4 Release Plan

sdlime edited this page Apr 10, 2013 · 5 revisions

New features in 6.4:

  • RFC 85: Vector Contour Rendering
  • RFC 86: Scale-dependant String Substitutions
  • RFC 87: Bitmap pattern support
  • RFC 88: Saving MapServer Objects to Strings
  • RFC 89: Layer Geomtransforms
  • RFC 90: Enable/Disable Layers in OGC Web Services by IP Lists
  • RFC 91: Layer Filter Normalization (may delay for major release)
  • RFC 92: Migrating from Autotools to CMake
  • RFC 94: Shape Smoothing
  • RFC 95: Support List Expressions
  • RFC 96: Time Dimension Support in MapCache Tilesets (is this a suite release plan or just MapServer?)

Other notable enhancements include:

  • List notable enhancements here...

Deprecated Features

  • None

See also the HISTORY.TXT for this release: https://github.com/mapserver/mapserver/blob/branch-6-4/HISTORY.TXT

(TODO: Add a link to the 6.2 => 6.4 migration guide.)

##Planned Dates

We will plan for 3 betas and 2 release candidates (RC) over a 6 week period after the feature freeze (1 beta/RC per week each Wednesday). This will lead us to a final release sometime around beginning of August 2012:

  • branch-6-4 creation, 6.4.0-beta1 : Fri. June 29th, 2012
  • 6.4.0-beta2 - Wed. Aug 1st
  • 6.4.0-beta3 - Wed. Aug 8th
  • 6.4.0-rc1 - Wed. Aug 15th
  • 6.4.0-rc2 - Wed. Aug 22nd
  • 6.4.0 (final) - Wed. Aug 29th

TBD

Git Tags/Branches

  • The current master branch is currently the 6.3 development version that we plan to release as 6.4
  • The stable branch for this release will be called "branch-6-4" (not created yet).
  • Once branch-6-2 is released, all commits targeted for 6.4 must be pushed to branch-6-4 only. Merging these fixes to master can/will be done by merging branch-6-4 into master. All commits to master should only concern features targeted for 6.6.
  • The betas will be tagged in SVN as "rel-6-4-0-beta1", "rel-6-4-0-beta2", ... and the release candidates as "rel-6-4-rc1", "rel-6-4-rc2", etc...

Managing HISTORY.TXT and Release Changelogs

  • Our practice of dealing with HISTORY.TXT needs to be updated in order to account for the more frequent merging practices that come with git usage.
  • Once 6.4 has been branched, commits to the stable branches are not reflected into HISTORY.TXT. Instead of this, the commit message must be sufficiently explicit to be incorporated in the stable branch Changelog that will be more or less automatically generated on release day. A typical commit message in a release branch should follow the following best practices (c.f. http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html ):
  • Use a short single line summary as the first line
  • include the ticket number in this first line
  • if additional information needs to be added, write them in a paragraph, ideally wrapped at 72 chars, after skipping a blank line.

An example commit message could be:

Fix incorrect handling of foobar (#XXXX)

Optional detailed message as to why this was needed,
along with any information that might seem relevant.
This commit message will appear when annotating the
source code, so any caveats or tricky implications can
be mentioned here to.

Ticket Conventions

In order to facilitate querying the Gihub issue database for tickets that still need to be addressed for this release, we try to stick to the following conventions:

  • Tickets to be addressed for this release must have their target milestone set to "6.2 release"
  • Bugs/Enhancements? that can't make it in this release but that we may want to address at a later time should be set to no milestone with a comment explaining that the bug is postponed and if possible a quick analysis
  • The target milestone on a ticket should be set by the developers (bug owners) and not by the users (reporters).

Other good practices when dealing with tickets:

  • Please file tickets for any non-trivial bugfix or change to the software. This is so that we keep a trace for future reference of all bugfixes and changes that were made (why and how).
  • Please assign yourself to an issue as soon as you start working on it.
  • Please include the bug number in the commit message, with the #xxxx notation. This will automatically link the commit to the ticket itself for future reference.
  • Issues can be automatically closed from a commit message. Include a line with "closes #xxxx" in your commit message.
  • Keep documentation in mind when fixing/changing things: if you cannot update the documentation yourself then please create a documentation bug describing the new feature/change and which document(s) should be updated.

The following query returns all currently open bugs that are tagged with the "6.4 release" target milestone: https://github.com/mapserver/mapserver/issues?milestone=35&state=open

You can further limit the issues assigned to you or targeting a specific component by clicking on the links to the left of the issue list

##QA TODO

##Open Tasks Update release procedure from svn->git

Clone this wiki locally