[PROJ] PROJ (and GDAL) webpages

Even Rouault even.rouault at spatialys.com
Fri Nov 15 15:26:06 PST 2024


>     EDIT: actually looking at
>     https://docs.readthedocs.io/en/stable/versions.html, I do read "If
>     you want a custom |stable| version, create either a tag or branch
>     in your project with that name.". So maybe we should just create a
>     git "stable" branch, but that means we need to regularly resync it
>     to the actual HEAD of the active 9.x git branch
>
> Looks like you found the proper and nice way to do it, right? Using a 
> tag (or branch) called "stable". I think that the overhead of the 
> release process is minimal. In PROJ it would replace the penultimate 
> line from https://github.com/OSGeo/PROJ/blob/master/HOWTO-RELEASE.md 
> if I understood correctly.
>
That's not so simple. There is no concept of automatic aliasing a git 
banch to another one. You can resync between them at will, but that must 
be done each time. So we'd likely need a tiny script doing something like:

git checkout stable
git fetch origin 9.5
git merge origin/9.5  # should be a forward merge (ie not merge commit)
git push origin stable

and running it regularly (at least each time a commit in 9.5 affects the 
doc)

and when releasing a new 9.6 version, at release time, recreating the 
stable branch it with

git checkout stable
git fetch origin 9.6
git reset --hard origin/9.6
git push -f origin stable

-- 

http://www.spatialys.com
My software is free, but my time generally not.
Butcher of all kinds of standards, open or closed formats. At the end, this is just about bytes.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/proj/attachments/20241116/1befec0e/attachment.htm>


More information about the PROJ mailing list