Debian GIS Policy

Andreas Tille

First review (Debian Med version) 

David Paleino

Initial writing (Debian Med version) 

Charles Plessy

Contributions in 2008 and 2011 (Debian Med version) 

Bas Couwenberg

Changes for Debian GIS version 

Source: https://anonscm.debian.org/cgit/pkg-grass/website.git/tree/policy.xml


Table of Contents

Introduction
How to Contribute
Membership
Essential readings
Repositories
Give me the source!
SSH tips
Git repository
Subversion repository
Migration of a source package from Subversion to Git
Packaging
Newcomer guidelines for building proper Debian packages
Announcing intent to package
Packaging with Git
Packaging with Subversion
Backports
PPA for Ubuntu by UbuntuGIS
Derivatives working together with Debian GIS
R packages
Sponsorship
Blend Tasks
Installing Debian GIS Blend tasks
Policy
debian/control
debian/copyright
debian/changelog
debian/upstream
debian/gbp.conf
debian/README.source
debian/README.test
debian/source/format
debian/source/option
debian/compat
Version control systems
New package
The Debian GIS Blend tasks
Building and tagging the packages
Handling patches
Contributing to the GIS Policy

Introduction

Debian GIS is a Debian Pure Blend with the aim to develop Debian into the best distribution for Geographical Information System applications and users.

A good deal of GIS related software and libraries (e.g. GRASS GIS, GDAL, and PROJ.4) are already present in Debian.

Thanks to efforts of the Debian GIS team, we currently have many exciting GIS packages in Debian's main archives. Other programs are well along their way to being included in the archive.

The Debian source packages maintained by the Debian GIS team are also used by efforts to support current GIS software on Debian derivatives such as UbuntuGIS, which provides backports of GIS packages for Ubuntu, and OSGeo-Live for their Ubuntu based distribution.

How to Contribute

From the developer to the user, there is a long chain of tasks in which we always welcome participation. First we must keep ourselves informed about the software landscape in GIS and/or OpenStreetMap. So you could help by monitor the GIS landscape for new and updated software and keeping the team informed. Software to be packaged is chosen according to criteria such as users' need and the consistency of the distribution.

Once in Debian, the software is monitored for its quality and bugs are fixed, if possible in collaboration with the upstream maintainer(s). So you could help out by triaging bugs, searching for patches or creating them, then testing the fixes and letting the team know.

All this work would not be very useful if it remains confidential or confined to the source packages of Debian and its derivative distributions. We also dedicate some time to advertise it to the world via www.debian.org and to ease the integration of new members. Maybe you could help out by writing articles about Debian GIS or the software we package? This could be for Magazines (online or in proint). Writing "HOWTO" articles is also a good way to help new users find their feet with the Debian GIS software.

Translating package descriptions (if you speak another language in addition to English), tagging packages with metadata, and uploading screenshots will also help users find the software that fulfills their needs.

Please contact us on debian-gis@lists.debian.org if you want to help to make GIS and/or OpenStreetMap software available to users of Debian and its derivative distributions such as Ubuntu, OSGeo-Live, Mint, etc. Read the Membership section if you're interested in joining us.

Translations

If you speak a language in addition to English, you can contribute right away with translations of package descriptions at ddtp.debian.net.

When working on these, you will find immediate targets for improvements of the original English versions, too. For these though, you need access to Debian GIS's source code repository.

A good route to find the Debian GIS descriptions needing translation is to use one of the Debian GIS task pages (for example the workstation task). If you are using a non-English locale, you should see that untranslated descriptions are in English, and there is a button you can click to contribute a translation. If you use an English locale, there are links at the bottom of the webpage that switch the webpage to other languages.

Debtags

You can also contribute and edit Debtags on the task pages. Debtags are used in Debian so that people can type in keywords and search for packages that they might need. Please help us to make sure a user will find our packages if they are searching for them. On the Debian GIS task pages, if a package is currently not tagged, you should see a "Go tagging" button. By clicking "Edit Tags", you can also double check the packages that have already been tagged.

Screenshots

A well chosen screenshot can also help to sell each Debian GIS package. Clicking on "Upload screenshot" on the Debian GIS tasks pages will take you to a page where you can upload a screenshot. Instructions can be found on the page that you are taken to. You can also click on an existing screen shot to send an updated one if you think the current one is out of date.

Squashing Bugs

If confirming bugs and contributing and testing patches are your thing, you can help triage the list of outstanding Debian GIS bugs.

You will find guidance on how to use the Debian Bug Tracking System (BTS) linked from this page: Debian Bug Tracking System

Policy Updates

This policy is a work in progress, and attempts to document best practices which evolve and change over time. Different people tend to do things in different ways. If your way diverges, you may want to document it here so that others can benefit. Please send any comments or ideas to debian-gis@lists.debian.org. For more details on contributing to the policy, see the Contributing to the GIS Policy section later in the policy.

Membership

To request membership of the Debian GIS team, and access to our collaboration infrastructure on Alioth, please go to our Alioth page or directly follow the Request to join link.

You need to register an Alioth account before you can request membership of the Debian GIS team, by submitting the User Account Registration form.

The Debian GIS team collaboration infrastructure on Alioth originates from the initial team effort to maintain the grass package. It has since grown to collaboratively maintain most GIS and OpenStreetMap source packages, but still uses the pkg-grass group name on Alioth.

Essential readings