有效地回報錯誤是協助 PostGIS 開發的基本方法。最有效的錯誤回報是能讓 PostGIS 開發人員重現該錯誤,因此理想情況下應包含觸發該錯誤的腳本,以及偵測到錯誤的環境相關的所有資訊。執行 SELECT postgis_full_version()
[針對 PostGIS] 和 SELECT version()
[針對 postgresql] 可以擷取足夠的資訊。
如果您使用的不是最新版本,最好先查看其發行版變更日誌,以了解您的錯誤是否已修正。
使用 PostGIS 錯誤追蹤器 可確保您的回報不會被丟棄,並讓您隨時掌握處理進度。回報新錯誤之前,請先查詢資料庫以查看是否為已知錯誤,如果是,請新增您擁有的任何新資訊。
在提交新回報之前,您可能需要閱讀 Simon Tatham 關於如何有效地回報錯誤的文章。
文件應準確反映軟體的功能和行為。如果沒有,可能是因為軟體錯誤,或者因為文件有誤或不足。
文件問題也可以回報至 PostGIS 錯誤追蹤器。
如果您的修改很小,只需在新的錯誤追蹤器問題中描述它,並明確說明其在文件中的位置。
如果您的變更較為廣泛,則強烈建議提供修補程式。以下是在 Unix 上進行的四個步驟(假設您已安裝 git):
複製 PostGIS 的 git 儲存庫。在 Unix 上,輸入
git clone https://git.osgeo.org/gitea/postgis/postgis.git
這將儲存在 postgis 目錄中
使用您喜愛的文字編輯器對文件進行變更。在 Unix 上,輸入(例如)
vim doc/postgis.xml
請注意,文件是以 DocBook XML 而非 HTML 撰寫,因此如果您不熟悉它,請參閱其他文件的範例。
建立一個包含與文件主要副本差異的修補程式檔。在 Unix 上,輸入
git diff doc/postgis.xml > doc.patch
將修補程式附加到錯誤追蹤器中的新問題。