[PROJ] PROJ (and GDAL) webpages

[Javier Jimenez Shaw]

On Sat, 16 Nov 2024 at 00:26, Even Rouault <even.rouault at spatialys.com>
wrote:

>
> 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
>
Wouldn't it be easier with a "tag" ? Just set (or re-set with -f) the tag
"stable" to the needed commit (that can be another tag, like "9.5.1")

>
> and running it regularly (at least each time a commit in 9.5 affects the
> doc)
>
After every change in doc? I would expect that stable is the last released
version. If there is anything changed in the doc, it will be in the next
release (or when we consider it important like the GDAL survey)

>
> 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
>
The same as above.

> --
>
> 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/3ca3d526/attachment.htm>