Informar sobre errores efectivamente es una manera fundamental de ayudar en el desarrollo de PostGIS. El informe de errores más efectivo es el que permite a los desarrolladores de PostGIS reproducirlo, así que lo ideal sería que contenga un trozo de código que lo genere y toda la información posible del entorno en el que fue detectado. Una información bastante buena se puede obtener ejecutando SELECT postgis_full_version() [para postgis] y SELECT version() [para postgresql].
Si no está usando la última versión, vale la pena echar un vistazo a su lista de cambios en la versión primero, para ver si el error ya se ha solucionado.
Usar el seguimiento de errores de PostGIS servirá para asegurarnos de que nuestros informes no son descartados, y nos mantendrá informados de como progresa su gestión. Antes de informar acerca de un nuevo error por favor consulte la base de datos para ver si es uno ya conocido, y si lo es, por favor, agregue la nueva información que tenga sobre él.
Puede leer la documentación de Simon Tatham acerca de Cómo informar de errores de manera eficiente antes de rellenar un nuevo informe.
La documentación debería reflejar con precisión las características y comportamiento del software. Si no es así, podría deberse a un error del software, o porque la documentación es deficiente o errónea.
Los problemas con la documentación se pueden enviar también al Seguimiento de errores de PostGIS.
Si su revisión es de poca importancia, tan sólo descríbala en un nuevo asunto de la lista de seguimiento, y sea específico acerca de en que parte de la documentación se encuentra.
Si sus cambios son más extensos, es preferible un envío por Subversion. Este es un proceso en cuatro pasos en Unix (suponiendo que tiene instalado ya Subversion):
Consiga una copia de la rama de PostGIS en Subversion. En Unix, teclee:
git clone https://git.osgeo.org/gitea/postgis/postgis.git
Ésta se almacenará en la carpeta ./trunk
Haga los cambios a la documentación con su editor favorito. En Unix, teclee (por ejemplo):
vim doc/postgis.xml
Tenga en cuenta que la documentación está escrita en DocBook XML y no en HTML, así que si no está familiarizado con este formato por favor siga el ejemplo del resto de la documentación.
Haga un fichero para solucionarlo que contenga las diferencias desde la copia maestra de la documentación. En Unix, teclee:
git diff doc/postgis.xml > doc.patch
Adjunte la solución a un nuevo tema en el seguimiento de errores.