PSC Vote: retire trac as Dev/User documentation storage
Darafei "Komяpa" Praliaskouski
me at komzpa.net
Thu Jul 9 12:54:59 PDT 2026
Hi,
TLDR: Let's drop docs from trac wiki (https://trac.osgeo.org/postgis/wiki)
to not confuse users to try to find something there, we saved the still
actual ones in git and manual already.
Trac was used a long time ago as a documentation storage. Since then
decades have passed, we have a website (at postgis.net), user handbook (
https://postgis.net/documentation/manual/), training materials (
https://github.com/postgis/postgis-workshops). Most pages are 15+ years old.
A gap that we had until recently was developer documentation. Existing
developers got some knowledge by osmosis, and in the last month we learned
we did not write down a lot of nuances by observing the common misses by
LLMs. As previously mentioned in
https://lists.osgeo.org/pipermail/postgis-devel/2026-June/030846.html
the notes collected during review of AI pull requests were combined with
trac content that is still relevant and pushed to
https://gitea.osgeo.org/postgis/postgis/src/branch/master/doc/development -
thanks everyone (especially Sandro and Regina) for the comments on the
changes and what needs to be in docs. Everyone is welcome to enhance these
docs.
So, I propose we delete documentation from trac wiki and agree to not add
more there in the future.
We also used trac for meeting notes, and tickets. These are out of scope
for this vote.
Thanks,
Darafei.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/postgis-devel/attachments/20260709/e265be80/attachment.htm>
More information about the postgis-devel
mailing list