RFC 3: GDAL Committer Guildlines

Author: Frank Warmerdam

Contact: warmerdam@pobox.com

Status: Adopted

Purpose

To formalize SVN (or CVS) commit access, and specify some guidelines for SVN committers.

Election to SVN Commit Access

Permission for SVN commit access shall be provided to new developers only if accepted by the GDAL/OGR Project Steering Committee. A proposal should be written to the PSC for new committers and voted on normally. It is not necessary to write an RFC document for these votes, a proposal to gdal-dev is sufficient.

Removal of SVN commit access should be handled by the same process.

The new committer should have demonstrated commitment to GDAL/OGR and knowledge of the GDAL/OGR source code and processes to the committee’s satisfaction, usually by reporting bugs, submitting patches, and/or actively participating in the GDAL/OGR mailing list(s).

The new committer should also be prepared to support any new feature or changes that he/she commits to the GDAL/OGR source tree in future releases, or to find someone to which to delegate responsibility for them if he/she stops being available to support the portions of code that he/she is responsible for.

All committers should also be a member of the gdal-dev mailing list so they can stay informed on policies, technical developments and release preparation.

New committers are responsible for having read, and understood this document.

Committer Tracking

A list of all project committers will be kept in the main gdal directory (called COMMITTERS) listing for each SVN committer:

  • Userid: the id that will appear in the SVN logs for this person.

  • Full name: the users actual name.

  • Email address: A current email address at which the committer can be reached. It may be altered in normal ways to make it harder to auto-harvest.

  • A brief indication of areas of responsibility.

SVN Administrator

One member of the Project Steering Committee will be designed the SVN Administrator. That person will be responsible for giving SVN commit access to folks, updating the COMMITTERS file, and other SVN related management. That person will need login access on the SVN server of course.

Initially Frank Warmerdam will be the SVN Administrator.

SVN Commit Practices

The following are considered good SVN commit practices for the GDAL/OGR project.

  • Use meaningful descriptions for SVN commit log entries.

  • Add a bug reference like “(#1232)” at the end of SVN commit log entries when committing changes related to a ticket in Trac. The ‘#’ character enables Trac to create a hyperlink from the changeset to the mentionned ticket.

  • After committing changes related to a ticket in Trac, write the tree and revision in which it was fixed in the ticket description. Such as “Fixed in trunk (r12345) and in branches/1.7 (r12346)”. The ‘r’ character enables Trac to create a hyperlink from the ticket to the changeset.

  • Changes should not be committed in stable branches without a corresponding bug id. Any change worth pushing into the stable version is worth a bug entry.

  • Never commit new features to a stable branch without permission of the PSC or release manager. Normally only fixes should go into stable branches.

  • New features go in the main development trunk.

  • Only bug fixes should be committed to the code during pre-release code freeze, without permission from the PSC or release manager.

  • Significant changes to the main development version should be discussed on the gdal-dev list before you make them, and larger changes will require a RFC approved by the PSC.

  • Do not create new branches without the approval of the PSC. Release managers are assumed to have permission to create a branch.

  • All source code in SVN should be in Unix text format as opposed to DOS text mode.

  • When committing new features or significant changes to existing source code, the committer should take reasonable measures to insure that the source code continues to build and work on the most commonly supported platforms (currently Linux and Windows), either by testing on those platforms directly, running [wiki:Buildbot] tests, or by getting help from other developers working on those platforms. If new files or library dependencies are added, then the configure.in, Makefile.in, Makefile.vc and related documentations should be kept up to date.

Relationship with other upstream projects imported in GDAL/OGR code base

Some parts of the GDAL/OGR code base are regularly refreshed from other upstream projects. So changes in those areas should go first into those upstream projects, otherwise they may be lost during a later refresh. Note that those directories may contain a mix of GDAL specific files and upstream files. This has to be checked on a case-by-case basis (any file with CVS changelog at its beginning is a good candidate for belonging to the upstream project)

Currently the list of those areas is :

Bootstraping

The following existing committers will be considered authorized GDAL/OGR committers as long as they each review the committer guidelines, and agree to adhere to them. The SVN administrator will be responsible for checking with each person.

  • Daniel Morissette

  • Frank Warmerdam

  • Gillian Walter

  • Andrey Kiselev

  • Alessandro Amici

  • Kor de Jong

  • Howard Butler

  • Lichun Wang

  • Norman Vine

  • Ken Melero

  • Kevin Ruland

  • Marek Brudka

  • Pirmin Kalberer

  • Steve Soule

  • Frans van der Bergh

  • Denis Nadeau

  • Oleg Semykin

  • Julien-Samuel Lacroix

  • Daniel Wallner

  • Charles F. I. Savage

  • Mateusz Loskot

  • Peter Nagy

  • Simon Perkins

  • Radim Blazek

  • Steve Halasz

  • Nacho Brodin

  • Benjamin Collins

  • Ivan Lucena

  • Ari Jolma

  • Tamas Szekeres