Momse: /* Announce the release */

2010-06-06T18:55:11Z

Announce the release

New page

This article documents the process of making a new PhpGedView release. Currently [[User:John Finlay|John Finlay]] and [[User:Greg Roach|Greg Roach]] are responsible for preparing new PhpGedView releases.

==Preparatory Tasks==
# At least one week before the release date, freeze the language files.
## Post to the developers forum asking that no more changes be made to language variables before the release date.
## Post to the translators forum asking translators to submit any pending changes before the release date.

==Packaging the Files==
# Identify the trunk/branch of phpGedView that you intend to release.
# Ensure the version number is correct in session.php (PGV_VERSION and PGV_VERSION_RELEASE).
# Ensure the version number is correct in build.xml (pgv.version).
# If any new modules have been added since the last release, you will need to add definitions for these in build.xml.
# If the database schema has changed (i.e. changes to includes/db_schema/*.php), then update the sqlite database file used by the democd application.
# Create a tag for the release in the tags directory of the SVN repository.
# Check out a working-copy of both the tagged directory and the distribution directory from the repository.
# If these two working copies are not in the same parent directory, update the "dist.dir" value in build.xml to the actual location of the distribution directory.
# Download the [http://ant.apache.org Apache Ant] build tool. To configure it, simply define the environment variable ANT_HOME as the location of the Ant root directory.
# Run Ant from the phpGedView directory using the appropriate command line for your operating system.
## "%ANT_HOME%\bin\ant"
## $ANT_HOME/bin/ant
# Ant takes approximately 5 minutes to run, and will generate all the required zip archives in the distribution directory.
## PhpGedView-all-Version
## PhpGedView-basic-Version
## PGV-Demo-Version
## PGV-Languages-Version
## PGV-Places-Version
## PGV-Themes-Version
## PGV-Modules-All-Version
## PGV-Module-XXX-Version (for each module XXX)

== Release the Files on SourceForge ==
Refer to the [https://sourceforge.net/apps/trac/sourceforge/wiki/Release%20files%20for%20download SourceForge release documentation] for information on how to create a release on SourceForge
# Upload the files using the [https://sourceforge.net/project/admin/explorer.php?group_id=55456 Web Upload Page]
# Set the basic package to be the default by clicking on it, and clicking the "select all platforms" option

== Update the Bugs Tracker on SourceForge ==
# The [https://sourceforge.net/tracker/admin/?group_id=55456&atid=634867&add_group=1 bugs tracker "group"] is used to record the PhpGedView version. Rename the latest version from, say "4.2.3 (svn)" to "4.2.3" and create "4.2.4 (svn)". Thus all outstanding bugs in the current SVN will be listed under the release.

== Update the PhpGedView Website ==
# Update the [http://www.phpgedview.net/ PhpGedView.net] website. The simplest way is to directly edit the website files using SSH. Refer to the sourceforge documentation for information on how to access the website files.

== Announce the release ==
It is usually a good idea to wait a day or two just in case there is something wrong with the package.
# Send out the release announcement to:
## the mailing lists
## the sourceforge users monitoring the release package
## Post a message in one of the sourceforge forums
## Add a News item on the SourceForge project page

== PGVWiki Tasks ==

After a new release is made, changes need to be made to some PGVWiki articles. Bug fix releases (e.g. {{latest stable series}}) require only a few changes to be made to existing templates and articles, whereas, minor releases (e.g. 4.x) and major releases (e.g. a version bump from 4.x to 5.x) will require a little more work.

; For Bug Fix Releases

:# Simply update [[Template:Latest version {{latest stable series}}]] to reflect the release date and version for the new release.

; For Minor Releases

:# Copy the contents of [[Template:Latest version {{latest stable series}}]] to the equivalent page for the new release e.g. [[Template:Latest version 4.2.x]] and update the release date and version of the new release.
:# Update [[Template:Latest stable series]] to indicate the latest stable series has incremented.
:# Update [[Template:Latest development]] to indicate the version number of the new development branch.
:# Update all references/links on this page from 4.2.x to 4.3.x

; For All Releases

:# Update file sizes of the new downloads on the [[Download v{{latest stable series}}]] and update any references/links required for the new release (in particular the '''patch download''', which patches from the previous version to the current version).
:# Ensure the following article exists ([[{{latest version|series={{latest stable series}}}}]]) with a redirect to [[PhpGedView v{{latest version|series={{latest stable series}}}}]]
:# Simply copy the contents of [[PhpGedView v4.1.3]] (or similar) to [[PhpGedView v{{latest version|series={{latest stable series}}}}]], changing any contents as needed.
:# Update the [[News]] section on the main page to show details of the new release.
:# Ensure the date pages for the new release ({{latest version|release date=1|series={{latest stable series}}}}) exist and appropriate content is added using information from a previous release as a template e.g. [[16 November]] and [[2007]]

== Wikipedia Tasks ==

The following [[w:Wikipedia|Wikipedia]] articles contain information about PhpGedView and thus need to be checked and updated after a release is made:

* The [[w:PhpGedView|PhpGedView]] article
* The [[w:Comparison_of_genealogy_software|Comparison of genealogy software]] article

[[Category:Developer_resources]]
[[Category:SVN]]

Preparing a PhpGedView Release - Revision history

Momse: /* Announce the release */