• ReleaseChecklist1.0

Release Checklist for QGIS 1.0.0

Mark completed items using the symbol

Release Focus Areas

Packaging Team

Packages should be uploaded to upload.osgeo.org into the appropriate subdirs under:

• /osgeo/download/qgis

After each package is uploaded, an entry can be created for it on the http://downloads.qgis.org using this url:

• http://spatialserver.net:3002/account/login

Then go to:

• http://spatialserver.net:3002

You need to have relevant accounts on the above servers.

Release Team

The following table provides a key for release responsibilities, as the release document that follows will be colour coded according to this key:

Two Month Release Timeline for QGIS

Post Release

Call for translators email

Hi All (and especially translators)
As of today please note that we are entering string freeze for the run up to the next release. If you are committing bug fixes please avoid changing any strings. Translation .ts files have been updated in SVN so please update your local svn checkouts. The period for translations will close MMMM-DD-YYYY (i.e. about one week from now) and then we will be branching for release. Any translations submitted to us after that time will only be included in the next release, so please submit what you have by then even if it is not complete.
As always you can track the release plans via the checklist at:
http://wiki.qgis.org/qgiswiki/ReleaseChecklist1.0.0
If you have any questions about the translation process, please see the following page which includes instructions on how to generate a .ts file for a new locale.
http://wiki.qgis.org/qgiswiki/TranslatorsCorner
Many thanks to all the translators out there for the great work you do!
Regards,

Branching and Tagging Details

Branch the release using syntax below (update this with the actual commands you used to tag).

svn cp https://svn.osgeo.org/qgis/trunk/qgis \
          https://svn.osgeo.org/qgis/branches/Release-1_0_0

Example of how to tag final release:

svn cp https://svn.osgeo.org/qgis/branches/Release-1_0_0 \
          https://svn.osgeo.org/qgis/tags/Release-1_0_0-Final

Bug Tracker System

All bugs that are intended to have been fixed in this release should have been marked as closed. All other bugs on the release branch should be marked for a future release. To do this:

• - create a new milestone and version e.g. we are releasing 1.0.0 now so create a new milestone in trac for 1.0.0+1. Create the milestone here: https://trac.osgeo.org/qgis/admin/ticket/milestones - make the new milestone default so that any new tickets get filed against that milestone - milestone should be in the form:

Version 1.0.0+1

Now you need to visit each open bug on the branch and reset its milestone for the next release in the future. This can be done easily doing the following:

Visit the milestone page by following this direct link: https://trac.osgeo.org/qgis/milestone/Version%201.0.0?action=edit or by clicking Roadmap Button -> Milestone Title -> Edit Milestone Info button. Now tick the completed checkbox and then the 'Retarget associated open tickets to milestone' checkbox and retarget the open tickets to the next milestone.

You can visit https://trac.osgeo.org/qgis/report/3 to get a report of bugs by milestone.

Create the source tarball

cd /tmp
svn export https://svn.osgeo.org/qgis/branches/Release-1_0_0 \
          qgis-1_0_0

Then use your favourite compression tool to create zip and .tar.bz2 archives.

Generate the changelog

Using command line and local SVN checkout (first no is svn revision of previous release, second is svn revision of this release):

svn log -r6350:7033 > /tmp/log.txt

or to be a little more fancy:

svn log -r7722:8242 | grep -i '^[a-z][a-z]' | sed -e "s\^\- \1" > /tmp/log.txt

Another way /additional way to generate a changelog is to use trac to get a list of all closed bugs e.g.

https://trac.osgeo.org/qgis/query?status=closed&milestone=Version+1.0.0&order=priority

Pro-forma call for packaging annoucnement:

Dear QGIS devs & packagers
Today I have branched 1.0.0. It would be great if you can assist by making packages for your preferred platform. The branch can be checked out at:
svn co https://svn.osgeo.org/qgis/branches/Release-1.0.0 qgis-1.0.0
Please do not commit anything to the branch except packaging related tweaks. Source packages will be made available shortly.
The release checklist at :
http://wiki.qgis.org/qgiswiki/ReleaseChecklist1.0.0
Has a list of people who have previously made packages. If you make a package for 1.0.0 please be so kind as to add the url to that wiki page in the section provided so that we can gather all the url packages in a systematic way. If you are able to make packages for unlisted platforms / distros please let me know so that we can avoid duplication of effort.
I would like to make the release announcement within the next week or so, so it will be great to have all packages ready by then.
SVN Trunk is open again for general commits but please not that we are aiming to do the next release within two months or so (timetable to be determined) and you should not make any major feature changes without prior discussion with PSC and Dev list.
Many thanks to all the developers, testers, bug fixers, bug reporters, document writers, translators and users that help to make QGIS a reality.
Best regards

Announcing the release

Create an announcement template

An annoucement templace will save you retypping the same text at the various places of announcement. The following text can be used as a basis:

A Generic release subject

Announcing the release of Quantum GIS version 1.0.0

A generic 20 word summary

Quantum GIS is a user friendly Open Source Geographic Information System that runs on Linux, Unix, Mac OSX, and Windows.

A mailing list announcement

It is our great pleasure to announce the immediate availability of Quantum GIS (QGIS) Version 1.0.0. See below for press release:
Quantum GIS (QGIS) is a user friendly Open Source Geographic Information System (GIS) that runs on Linux, Unix, Mac OSX, and Windows. QGIS supports vector, raster, and database formats. QGIS is licensed under the GNU General Public License. QGIS lets you browse and create map data on your computer. It supports many common spatial data formats (e.g. ESRI ShapeFile, geotiff). QGIS supports plugins to do things like display tracks from your GPS. QGIS is Open Source software and its free of cost (download here). We welcome contributions from our user community in the form of code contributions, bug fixes, bug reports, contributed documentation, advocacy and supporting other users on our mailing lists and forums. Financial contributions  are also welcome. This release introduces several new features including python support and many new GRASS modules. The release also includes numerous bug fixes and stability improvements. QGIS is available is source form, and as binary executables for Microsoft Windows, Mac OS X, and GNU/Linux. All versions can be obtained from our download page at http://download.qgis.org . As an open source project, we provide support for using QGIS via our mailing lists and bug tracker:
    * For general inquiries subscribe to our users mailing list at http://lists.qgis.org/cgi-bin/mailman/listinfo/qgis-user
    * For developer related inquiries subscribe to our separate developers list at http://lists.qgis.org/cgi-bin/mailman/listinfo/qgis-developer
    * If you think you have found a bug, please report it using our bug tracker. When reporting bugs, please include some contact information in case we need help with replicating your issue at https://trac.osgeo.org/qgis
Major changes in this release are:
 * item 1
 * item 2
 * etc
QGIS is a completely volunteer driven project, and is the work of a dedicated team of developers, documenters and supporters. We extend our thanks and gratitude for the  many, many hours people have contributed to make this release happen.

A generic short html announcement

It is our great pleasure to announce the immediate availability of Quantum GIS (QGIS) Version 1.0.0. Quantum GIS (QGIS) is a user friendly Open Source Geographic Information System (<a href="http://en.wikipedia.org/wiki/GIS">GIS</a>) that runs on Linux, Unix, Mac OSX, and Windows. QGIS supports vector, raster, and database formats. QGIS is licensed under the GNU General Public License. QGIS lets you <a href="http://qgis.org/flash/flashwrapper.php?filename=qgisdemo1.swf" title="QGIS demo">browse</a> and create map data on your computer. It supports many common spatial data formats (e.g. ESRI ShapeFile, geotiff). QGIS supports plugins to do things like <a href="http://qgis.org/flash/flashwrapper.php?filename=gpx_demo.swf"
title="GPS demo">display tracks</a> from your GPS. QGIS is Open Source software and its free of cost (<a href="http://download.qgis.org/">download here</a>). We welcome contributions from our user community in the form of
<a href = "http://wiki.qgis.org/qgiswiki/DevelopersCorner" title="Developers Corner">code contributions</a>, <a href="https://qgis.org/trac">bug fixes</a>, <a href="https://qgis.org/trac/newticket">bug reports</a>, <a href="http://wiki.qgis.org/qgiswiki/DocumentationWritersCorner">contributed documentation</a>, advocacy and supporting other users on our <a href="http://qgis.org/content/view/115/96">mailing lists</a> and <a href="http://forum.qgis.org/">forums</a>.
<a href = "http://qgis.org/content/view/97/73/" title = "Contribute">
Financial contributions
</a>
 are also welcome.
This release introduces several new features including python bindings and many additional GRASS modules. The release also includes bug fixes and stability improvements. QGIS is available is source form, and as binary executables for Microsoft Windows, Mac OS X, and GNU/Linux. All versions can be obtained from our <a href="http://download.qgis.org">download page</a>.
As an open source project, we provide support for using QGIS via our mailing lists and bug tracker:
<ul>
<li>For general enquiries <a href="http://lists.qgis.org/cgi-bin/mailman/listinfo/qgis-user">subscribe</a> to our users mailing list.</li>
<li>For developer related enquiries <a href="http://lists.qgis.org/cgi-bin/mailman/listinfo/qgis-developer">subscribe</a> to our separate developers list.</li>
<li>If you think you have found a bug, please report it using our <a href="https://trac.osgeo.org/qgis">bug tracker</a>. When reporting bugs, please include some contact information in case we need help with replicating your issue.</li>
</ul>

A generic short plain text announcement

It is our great pleasure to announce the immediate availability of Quantum GIS (QGIS) Version 1.0.0 Quantum GIS (QGIS) is a user friendly Open Source Geographic Information System (GIS) that runs on Linux, Unix, Mac OSX, and Windows. QGIS supports vector, raster, and database formats. QGIS is licensed under the GNU General Public License. QGIS lets you browse and create map data on your computer. It supports many common spatial data formats (e.g. ESRI ShapeFile, geotiff). QGIS supports plugins to do things like display tracks from your GPS. QGIS is Open Source software and its free of cost (download here). We welcome contributions from our user community in the form of code contributions, bug fixes, bug reports, contributed documentation, advocacy and supporting other users on our mailing lists and forums. Financial contributions  are also welcome. This release introduces several new features including python support and many new GRASS modules. The release also includes numerous bug fixes and stability improvements. QGIS is available is source form, and as binary executables for Microsoft Windows, Mac OS X, and GNU/Linux. All versions can be obtained from our download page. As an open source project, we provide support for using QGIS via our mailing lists and bug tracker:
    * For general enquiries subscribe to our users mailing list at http://lists.qgis.org/cgi-bin/mailman/listinfo/qgis-user
    * For developer related enquiries subscribe to our separate developers list at http://lists.qgis.org/cgi-bin/mailman/listinfo/qgis-developer
    * If you think you have found a bug, please report it using our bug tracker. When reporting bugs, please include some contact information in case we need help with replicating your issue at https://trac.osgeo.org/qgis

For a longer annoucement, include the changelog text and a screenshot of some shiny new feature.

A generic product description

Quantum GIS (QGIS) is a user friendly Open Source Geographic Information System (GIS) that runs on Linux, Unix, Mac OSX, and Windows. QGIS supports vector, raster, and database formats. QGIS is licensed under the GNU General Public License. QGIS lets you browse and create map data on your computer. It supports many common spatial data formats (e.g. ESRI ShapeFile, geotiff). QGIS supports plugins to do things like display tracks from your GPS. QGIS is Open Source software and its free of cost.

A generic features list

    * Support for spatially enabled PostGIS tables
    * Support for shapefiles, ArcInfo coverages, Mapinfo, and other formats supported by OGR
    * Raster support for a large number of formats
    * Identify/select/label features
    * OGC Support (WMS, WFS)
    * Digitizing OGR/Shape and GRASS files
    * Edit/View/Search attribute tables
    * Export to Mapserver map file
    * GRASS integration including view, edit and analysis
    * Python bindings
    * On the fly projection
    * Georeferencing
    * Print Composer
    * Extensible plugin architecture