Skip to content
Commits on Source (15)
docbook.css
policy.html
policy/*.html
IndexOptions +SuppressSize +DescriptionWidth=* +SuppressHTMLPreamble +XHTML
HeaderName HEADER.html
ReadmeName readme.txt
IndexIgnore HEADER.html readme.txt *.css *.png *.ico img
AddDescription "The DebianGis Manifesto -- first announcement of the DebianGis Project" announcement.txt
AddDescription "Debian GIS Policy - DocBook Stylesheet" docbook.css
AddDescription "Debian GIS Policy - Custom Stylesheet" policy.css
AddDescription "Debian GIS Policy - HTML version" policy.html
AddDescription "Debian GIS Policy - DocBook XML source" policy.xml
AddDescription "Debian GIS Policy - Build script" Makefile
AddDescription "Debian GIS Policy - Multi-page HTML version" policy
AddDescription "Old website content" attic
AddDescription "JOSM Redirector for uscan." josmredir.php
Redirect /qgis /attic/qgis
Redirect /arrow.png /attic/arrow.png
Redirect /debiangis.css /attic/debiangis.css
Redirect /debiangis-status.html /attic/debiangis-status.html
Redirect /debiangis-vs-unstable.html /attic/debiangis-status.html
Redirect /debpool.txt /attic/debpool.txt
Redirect /dgis.asc /attic/dgis.asc
Redirect /dgis-status.pl.txt /attic/dgis-status.pl.txt
Redirect /foo /attic/foo
Redirect /icons /attic/icons
Redirect /officiallogo-50.jpg /attic/officiallogo-50.jpg
Redirect /openlogo-100.jpg /attic/openlogo-100.jpg
Redirect /readme.txt /attic/readme.txt
Redirect /status.html /attic/status.html
Redirect /tarballs /attic/tarballs
Redirect /ubuntugis-status.html /attic/ubuntugis-status.html
Redirect /wiki.css /attic/wiki.css
PUBLISHHOST=alioth.debian.org
PUBLISHDIR=/home/groups/pkg-grass/htdocs
all: policy
policy: valid spellcheck
......@@ -11,13 +8,10 @@ policy: valid spellcheck
--param use.id.as.filename 1 \
--param make.valid.html 1 \
--stringparam html.stylesheet policy.css \
--stringparam base.dir policy/ \
--stringparam base.dir public/policy/ \
/usr/share/xml/docbook/stylesheet/docbook-xsl/xhtml/chunk.xsl \
policy.xml 2>/dev/null
clean:
rm -f docbook.css policy/*.html
valid:
xmllint --valid --noout policy.xml
......@@ -27,6 +21,3 @@ spellcheck:
spellcheck-fix:
codespell -w -s policy.xml
publish: policy
rsync -av .gitignore .htaccess * $(PUBLISHHOST):$(PUBLISHDIR) || true
ssh $(PUBLISHHOST) "chmod -R g+w $(PUBLISHDIR)/*" || true
pages:
script:
- echo "No build required"
artifacts:
paths:
- public
only:
- master
This diff is collapsed.
......@@ -21,7 +21,7 @@
<h2>What is Debian GIS?</h2>
<p>Debian GIS is a <a href="http://blends.debian.org/blends">Debian Pure Blend</a> with the aim to develop Debian into the best distribution for <strong>Geographical Information System</strong> applications and users.</p>
<p>Debian GIS is a <a href="http://blends.debian.org/blends">Debian Pure Blend</a> with the aim to develop Debian into the best distribution for <strong>Geographical Information System</strong> applications and users.</p>
<p>A good deal of GIS related software and libraries (e.g. GRASS GIS, GDAL, and PROJ.4) are already present in Debian.</p>
......@@ -29,18 +29,12 @@
<p>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.</p>
<p>The Debian GIS team collaboration infrastructure on Alioth originates from the initial team effort to maintain the <a href="https://tracker.debian.org/pkg/grass">grass</a> package. It has since grown to collaboratively maintain most GIS and OpenStreetMap source packages, but still uses the <em>pkg-grass</em> group name on Alioth.</p>
<h2>Contact Information:</h2>
We use:
<dl>
<dt><a href="https://alioth.debian.org/projects/pkg-grass/">https://alioth.debian.org/projects/pkg-grass/</a></dt>
<dd>for group management, git repositories, and this webspace</dd>
<dt><a href="https://anonscm.debian.org/cgit/pkg-grass/">https://anonscm.debian.org/cgit/pkg-grass/</a></dt>
<dt><a href="https://salsa.debian.org/debian-gis-team">https://salsa.debian.org/debian-gis-team</a></dt>
<dd>for storing of and working on our packages</dd>
......@@ -82,8 +76,8 @@
<h2>A note on joining:</h2>
<p>If you want to join the group you need to register an account on <a href="https://alioth.debian.org/account/register.php">alioth</a> and ask for being added to the pkg-grass group, preferrably by sending a short introduction mail to <a href="mailto:debian-gis@lists.debian.org">debian-gis@lists.debian.org</a>.<br />
Please don't forget to read the documents below! (Specifically the <a href="policy.html">Debian GIS Policy</a>)</p>
<p>If you want to join the group you need to register an account on <a href="https://salsa.debian.org/">Salsa</a> and ask for being added to the <a href="https://salsa.debian.org/debian-gis-team">debian-gis-team</a> group, preferrably by sending a short introduction mail to <a href="mailto:debian-gis@lists.debian.org">debian-gis@lists.debian.org</a>.<br />
Please don't forget to read the the <a href="policy.html">Debian GIS Policy</a>!</p>
</div>
</body>
</html>
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="refresh" content="0; url=policy/index.html">
<title>Debian GIS Policy</title>
</head>
<body>
Please, wait while you are being redirected to the Debian GIS Policy.<br/>
If your browser does not automatically redirect to it, click on the link below:<br/>
<a href="policy/index.html">Debian GIS Policy</a><br/>
<br/>
<em>With compliments of your friendly neighbor Debian GIS Team</em>
</body>
</html>
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Debian GIS Policy</title><link rel="stylesheet" type="text/css" href="policy.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.79.1" /><link rel="home" href="index.html" title="Debian GIS Policy" /><link rel="next" href="repositories.html" title="Repositories" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Debian GIS Policy</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="repositories.html">Next</a></td></tr></table><hr /></div><div class="article"><div class="titlepage"><div><div><h2 class="title"><a id="idm1"></a>Debian GIS Policy</h2></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">Andreas</span> <span class="surname">Tille</span></h3><span class="contrib">First review (Debian Med version)</span> <code class="email">&lt;<a class="email" href="mailto:tille@debian.org">tille@debian.org</a>&gt;</code></div><div class="author"><h3 class="author"><span class="firstname">David</span> <span class="surname">Paleino</span></h3><span class="contrib">Initial writing (Debian Med version)</span> <code class="email">&lt;<a class="email" href="mailto:d.paleino@gmail.com">d.paleino@gmail.com</a>&gt;</code></div><div class="author"><h3 class="author"><span class="firstname">Charles</span> <span class="surname">Plessy</span></h3><span class="contrib">Contributions in 2008 and 2011 (Debian Med version)</span> <code class="email">&lt;<a class="email" href="mailto:plessy@debian.org">plessy@debian.org</a>&gt;</code></div><div class="author"><h3 class="author"><span class="firstname">Bas</span> <span class="surname">Couwenberg</span></h3><span class="contrib">Changes for Debian GIS version</span> <code class="email">&lt;<a class="email" href="mailto:sebastic@debian.org">sebastic@debian.org</a>&gt;</code></div></div></div><div><p class="releaseinfo">
Source:
<a class="ulink" href="https://salsa.debian.org/debian-gis-team/website/blob/master/policy.xml" target="_top">https://salsa.debian.org/debian-gis-team/website/blob/master/policy.xml</a>
</p></div></div><hr /></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="sect1"><a href="index.html#introduction">Introduction</a></span></dt><dd><dl><dt><span class="sect2"><a href="index.html#contribute">How to Contribute</a></span></dt><dt><span class="sect2"><a href="index.html#membership">Membership</a></span></dt><dt><span class="sect2"><a href="index.html#readings">Essential readings</a></span></dt></dl></dd><dt><span class="sect1"><a href="repositories.html">Repositories</a></span></dt><dd><dl><dt><span class="sect2"><a href="repositories.html#source">Give me the source!</a></span></dt><dt><span class="sect2"><a href="repositories.html#ssh-tips">SSH tips</a></span></dt><dt><span class="sect2"><a href="repositories.html#git-repository">Git repository</a></span></dt></dl></dd><dt><span class="sect1"><a href="packaging.html">Packaging</a></span></dt><dd><dl><dt><span class="sect2"><a href="packaging.html#packaging-guidelines">Newcomer guidelines for building proper Debian packages</a></span></dt><dt><span class="sect2"><a href="packaging.html#itp">Announcing intent to package</a></span></dt><dt><span class="sect2"><a href="packaging.html#git-packaging">Packaging with Git</a></span></dt><dt><span class="sect2"><a href="packaging.html#backports">Backports</a></span></dt><dt><span class="sect2"><a href="packaging.html#ubuntugis-ppa">PPA for Ubuntu by UbuntuGIS</a></span></dt><dt><span class="sect2"><a href="packaging.html#derivatives">Derivatives working together with Debian GIS</a></span></dt><dt><span class="sect2"><a href="packaging.html#r-packages">R packages</a></span></dt><dt><span class="sect2"><a href="packaging.html#sponsorship">Sponsorship</a></span></dt></dl></dd><dt><span class="sect1"><a href="tasks.html">Blend Tasks</a></span></dt><dd><dl><dt><span class="sect2"><a href="tasks.html#installing-tasks">Installing Debian GIS Blend tasks</a></span></dt></dl></dd><dt><span class="sect1"><a href="policy.html">Policy</a></span></dt><dd><dl><dt><span class="sect2"><a href="policy.html#debian-control"><code class="filename">debian/control</code></a></span></dt><dt><span class="sect2"><a href="policy.html#debian-copyright"><code class="filename">debian/copyright</code></a></span></dt><dt><span class="sect2"><a href="policy.html#debian-changelog"><code class="filename">debian/changelog</code></a></span></dt><dt><span class="sect2"><a href="policy.html#debian-upstream"><code class="filename">debian/upstream</code></a></span></dt><dt><span class="sect2"><a href="policy.html#debian-gbp.conf"><code class="filename">debian/gbp.conf</code></a></span></dt><dt><span class="sect2"><a href="policy.html#debian-readme-source"><code class="filename">debian/README.source</code></a></span></dt><dt><span class="sect2"><a href="policy.html#debian-readme-test"><code class="filename">debian/README.test</code></a></span></dt><dt><span class="sect2"><a href="policy.html#debian-source-format"><code class="filename">debian/source/format</code></a></span></dt><dt><span class="sect2"><a href="policy.html#debian-source-option"><code class="filename">debian/source/option</code></a></span></dt><dt><span class="sect2"><a href="policy.html#debian-compat"><code class="filename">debian/compat</code></a></span></dt><dt><span class="sect2"><a href="policy.html#vcs">Version control systems</a></span></dt><dt><span class="sect2"><a href="policy.html#new-package">New package</a></span></dt><dt><span class="sect2"><a href="policy.html#new-packages-in-tasks">The Debian GIS Blend tasks</a></span></dt><dt><span class="sect2"><a href="policy.html#building-and-tagging">Building and tagging the packages</a></span></dt><dt><span class="sect2"><a href="policy.html#patches">Handling patches</a></span></dt><dt><span class="sect2"><a href="policy.html#contributing">Contributing to the GIS Policy</a></span></dt></dl></dd></dl></div><div class="mediaobject" align="center"><img src="img/debiangis_mollweide.png" align="middle" /></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="introduction"></a>Introduction</h2></div></div></div><div class="toc"><dl class="toc"><dt><span class="sect2"><a href="index.html#contribute">How to Contribute</a></span></dt><dd><dl><dt><span class="sect3"><a href="index.html#translations">Translations</a></span></dt><dt><span class="sect3"><a href="index.html#debtags">Debtags</a></span></dt><dt><span class="sect3"><a href="index.html#screenshots">Screenshots</a></span></dt><dt><span class="sect3"><a href="index.html#bugs">Squashing Bugs</a></span></dt><dt><span class="sect3"><a href="index.html#policy-updates">Policy Updates</a></span></dt></dl></dd><dt><span class="sect2"><a href="index.html#membership">Membership</a></span></dt><dt><span class="sect2"><a href="index.html#readings">Essential readings</a></span></dt></dl></div><p>
Debian GIS is a
<span class="quote"><span class="quote"><a class="ulink" href="https://blends.debian.org/blends" target="_top">Debian Pure Blend</a></span></span>
with the aim to develop Debian into the best distribution for
Geographical Information System applications and users.
</p><p>
A good deal of GIS related software and libraries (e.g. GRASS GIS, GDAL,
and PROJ.4) are already present in Debian.
</p><p>
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.
</p><p>
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 <a class="ulink" href="https://wiki.ubuntu.com/UbuntuGIS" target="_top">UbuntuGIS</a>,
which provides backports of GIS packages for Ubuntu,
and <a class="ulink" href="https://live.osgeo.org/" target="_top">OSGeo-Live</a> for their
Ubuntu based distribution.
</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="contribute"></a>How to Contribute</h3></div></div></div><div class="toc"><dl class="toc"><dt><span class="sect3"><a href="index.html#translations">Translations</a></span></dt><dt><span class="sect3"><a href="index.html#debtags">Debtags</a></span></dt><dt><span class="sect3"><a href="index.html#screenshots">Screenshots</a></span></dt><dt><span class="sect3"><a href="index.html#bugs">Squashing Bugs</a></span></dt><dt><span class="sect3"><a href="index.html#policy-updates">Policy Updates</a></span></dt></dl></div><p>
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.
</p><p>
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.
</p><p>
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
<a class="ulink" href="https://www.debian.org" target="_top">www.debian.org</a>
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.
</p><p>
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.
</p><p>
Please contact us on
<a class="ulink" href="mailto:debian-gis@lists.debian.org" target="_top">debian-gis@lists.debian.org</a>
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 <a class="link" href="index.html#membership" title="Membership">Membership</a>
section if you're interested in joining us.
</p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="translations"></a>Translations</h4></div></div></div><p>
If you speak a language in addition to English, you can contribute right away
with translations of package descriptions at
<a class="ulink" href="http://ddtp.debian.net" target="_top">ddtp.debian.net</a>.
</p><p>
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.
</p><p>
A good route to find the Debian GIS descriptions needing translation is
to use one of the Debian GIS task pages (for example the
<a class="ulink" href="https://blends.debian.org/gis/tasks/workstation" target="_top">workstation task</a>).
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.
</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="debtags"></a>Debtags</h4></div></div></div><p>
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 "<a class="ulink" href="https://debtags.debian.org/edit/" target="_top">Go tagging</a>"
button.
By clicking "Edit Tags", you can also double check the packages that
have already been tagged.
</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="screenshots"></a>Screenshots</h4></div></div></div><p>
A well chosen screenshot can also help to sell each Debian GIS package.
Clicking on
"<a class="ulink" href="https://screenshots.debian.net/" target="_top">Upload screenshot</a>"
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.
</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="bugs"></a>Squashing Bugs</h4></div></div></div><p>
If confirming bugs and contributing and testing patches are your thing,
you can help triage the list of outstanding
<a class="ulink" href="https://bugs.debian.org/cgi-bin/pkgreport.cgi?which=maint&amp;data=pkg-grass-devel%40lists.alioth.debian.org&amp;archive=no&amp;raw=yes&amp;bug-rev=yes&amp;pend-exc=fixed&amp;pend-exc=done" target="_top">Debian GIS bugs</a>.
</p><p>
You will find guidance on how to use the Debian Bug Tracking System (BTS)
linked from this page: <a class="ulink" href="https://www.debian.org/Bugs/" target="_top">Debian Bug Tracking System</a>
</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="policy-updates"></a>Policy Updates</h4></div></div></div><p>
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
<a class="ulink" href="mailto:debian-gis@lists.debian.org" target="_top">debian-gis@lists.debian.org</a>.
For more details on contributing to the policy, see the
<a class="link" href="policy.html#contributing" title="Contributing to the GIS Policy">Contributing to the GIS Policy</a>
section later in the policy.
</p></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="membership"></a>Membership</h3></div></div></div><p>
To request membership of the Debian GIS team, and commit access to our git
repositories on Salsa, please go to our
<a class="ulink" href="https://salsa.debian.org/debian-gis-team" target="_top">Salsa page</a>
and click the Request Access button.
</p><p>
You need to register a Salsa account before you can request
membership of the Debian GIS team (if you are not a Debian Developer),
by creating a guest account using the
<a class="ulink" href="https://signup.salsa.debian.org/" target="_top">Debian GitLab self-service</a>
interface.
</p><p>
The Debian GIS team collaboration infrastructure was originally hosted
on Alioth which provided VCS hosting, mailinglists and website hosting.
</p><p>
The team grew out of the initial effort to collaboratively maintain the
<a class="ulink" href="https://tracker.debian.org/pkg/grass" target="_top">grass</a>
package, and ended up collaboratively maintaining most GIS and
OpenStreetMap source packages, while still using the
<code class="literal">pkg-grass</code> group name on Alioth.
</p><p>
On Salsa the <code class="literal">debian-gis-team</code> namespace is used, but
the mailinglist for the Maintainer address in packages still uses
<code class="literal">pkg-grass</code> in its name thanks to its origin on Alioth.
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="readings"></a>Essential readings</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
The
<a class="ulink" href="https://www.debian.org/doc/debian-policy/" target="_top">Debian Policy</a>:
packages must conform to it.
</p></li><li class="listitem"><p>
The
<a class="ulink" href="https://www.debian.org/doc/developers-reference/" target="_top">Developers Reference</a>:
details best packaging practices.
</p></li><li class="listitem"><p>
The
<a class="ulink" href="https://www.debian.org/doc/maint-guide/" target="_top">New Maintainer's Guide</a>:
puts a bit of the two above in practice.
</p></li><li class="listitem"><p>
The
<a class="ulink" href="https://debian-gis-team.pages.debian.net/website/policy.html" target="_top">Debian GIS Policy</a>
(this document): explains how the work is organized in our team.
</p></li></ul></div></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="repositories.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"> </td><td width="40%" align="right" valign="top"> Repositories</td></tr></table></div></body></html>
\ No newline at end of file
This diff is collapsed.