Effektive Fehlerberichte sind ein wesentlicher Beitrag zur Weiterentwicklung von PostGIS. Am wirksamsten ist ein Fehlerbericht dann, wenn er von den PostGIS-Entwicklern reproduziert werden kann. Idealerweise enthält er ein Skript das den Fehler auslöst und eine vollständige Beschreibung der Umgebung in der er aufgetreten ist. Ausreichend gute Information liefert SELECT postgis_full_version() [für PostGIS] und SELECT version() [für PostgreSQL].
Falls Sie nicht die aktuelle Version verwenden, sollten Sie zuerst unter release changelog nachsehen, ob Ihr Bug nicht bereits bereinigt wurde.
Die Verwendung des PostGIS bug tracker stellt sicher dass Ihre Berichte nicht verworfen werden, und dass Sie über die Prozessabwicklung am Laufenden gehalten werden. Bevor Sie einen neuen Fehler melden fragen Sie bitte die Datenbank ab ob der Fehler schon bekannt ist. Wenn es ein bekannter Fehler ist, so fügen Sie bitte jegliche neue Information die Sie herausgefunden haben hinzu.
Vielleicht möchten Sie zuvor Simon Tatham's Artikel über How to Report Bugs Effectively lesen, bevor Sie einen Fehlerbericht senden.
Die Dokumentation sollte die Eigenschaften und das Verhalten der Software exakt wiederspiegeln. Wenn das nicht der Fall ist, so kann entweder ein Softwarebug oder eine fehlerhafte bzw. unzulängliche Dokumentation daran Schuld sein.
Probleme in der Dokumentation können unter PostGIS bug tracker gemeldet werden.
Wenn die Überarbeitung trivial ist, können Sie diese in einem neuen Bug Tracker Issue beschreiben. Geben Sie bitte die exakte Stelle in der Dokumentation an.
Wenn es sich um umfangreichere Änderungen handelt, ist ein Subversion Patch zweifellos die bessere Wahl. Dabei handelt es sich um einen vierstufigen Vorgang unter Unix (angenommen, Sie haben Subversion bereits installiert):
Eine Kopie des PostGIS Subversion Trunks auschecken. Eingabe unter Unix:
git clone https://git.osgeo.org/gitea/postgis/postgis.git
Dies wird im Verzeichnis ./trunk gespeichert
Erledigen Sie die Änderungen an der Dokumentation mit Ihrem Lieblingstexteditor. Auf Unix, tippen Sie (zum Beispiel):
vim doc/postgis.xml
Bedenken Sie bitte, dass die Dokumentation in DocBook XML und nicht in HTML geschrieben ist. Falls Sie damit nicht vertraut sind, so folgen Sie bitte dem Beispiel in der restlichen Dokumentation.
Erzeugung einer Patchdatei, welche die Unterschiede zur Master-Kopie der Dokumentation enthält. Unter Unix tippen Sie bitte:
git diff doc/postgis.xml > doc.patch
Fügen Sie den Patch einem neuen Thema/Issue im Bug Tracker bei.