Meaning of GDAL's git "stable" branch

--===============2758428020643857114==
Content-Type: multipart/alternative; boundary="0000000000009b48260655188d94"

--0000000000009b48260655188d94
Content-Type: text/plain; charset="UTF-8"

Hi all,

I'm being asked the meaning of https://github.com/OSGeo/gdal/tree/stable
and realized I don't really know what that branch is all about. I'm likely
just missing some documentation or discussion, so I apologize in advance.

I see in HOWTO-RELEASE, there is mention of `STABLE_BRANCH`. Is this
related?

https://github.com/OSGeo/gdal/blob/6a231dc29bfeb734227f7e646fe7c41b59e3167d/HOWTO-RELEASE#L105-L121

It points to
https://github.com/OSGeo/GDAL/settings/variables/actions/STABLE_BRANCH, and
it looks like git commits are from the current "STABLE_BRANCH" (e.g., 3.13)
are also pushed onto a "stable" branch:

https://github.com/OSGeo/gdal/blob/6a231dc29bfeb734227f7e646fe7c41b59e3167d/.github/workflows/auto_tag_stable.yml#L49-L50

There is a comment about a unique SHA so that ReadTheDocs gets run. It
looks that this is so that the "stable" Read the Docs link always has the
most recent text on the most current release branch whereas the release/X.Y
will be only updated when a release happens? That doesn't seem right as
right now stable is 4 hours ago and release/3/13 is 6 hours ago:
https://app.readthedocs.org/projects/gdal/ e.g. for these:

https://gdal.org/en/latest/
https://gdal.org/en/stable/
https://gdal.org/en/release-3.13/

Do I have any of that correct and what is the semantic meaning of the
"stable" branch that users should read into it?

Thanks!
-Kurt

--0000000000009b48260655188d94
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr">Hi all,<div><br></div><div>I&#39;m being asked the meaning=
 of=C2=A0<a href=3D"https://github.com/OSGeo/gdal/tree/stable">https://gith=
ub.com/OSGeo/gdal/tree/stable</a> and realized I don&#39;t really know what=
 that branch is all about. I&#39;m likely just missing some documentation o=
r discussion, so I apologize in advance.</div><div><br></div><div>I see in =
HOWTO-RELEASE, there is mention of `STABLE_BRANCH`. Is this related?</div><=
div><br></div><div><a href=3D"https://github.com/OSGeo/gdal/blob/6a231dc29b=
feb734227f7e646fe7c41b59e3167d/HOWTO-RELEASE#L105-L121">https://github.com/=
OSGeo/gdal/blob/6a231dc29bfeb734227f7e646fe7c41b59e3167d/HOWTO-RELEASE#L105=
-L121</a></div><div><br></div><div>It points to=C2=A0<a href=3D"https://git=
hub.com/OSGeo/GDAL/settings/variables/actions/STABLE_BRANCH">https://github=
.com/OSGeo/GDAL/settings/variables/actions/STABLE_BRANCH</a>, and it looks =
like git commits are from the current=C2=A0&quot;STABLE_BRANCH&quot; (e.g.,=
 3.13) are also pushed onto a &quot;stable&quot; branch:</div><div><br></di=
v><div><a href=3D"https://github.com/OSGeo/gdal/blob/6a231dc29bfeb734227f7e=
646fe7c41b59e3167d/.github/workflows/auto_tag_stable.yml#L49-L50">https://g=
ithub.com/OSGeo/gdal/blob/6a231dc29bfeb734227f7e646fe7c41b59e3167d/.github/=
workflows/auto_tag_stable.yml#L49-L50</a></div><div><br></div><div>There is=
 a comment about a unique SHA so that=C2=A0ReadTheDocs gets run. It looks t=
hat this is so that the &quot;stable&quot; Read the Docs link always has th=
e most recent text on the most current release branch whereas the release/X=
.Y will be only updated when a release happens? That doesn&#39;t seem right=
 as right now stable is 4 hours ago and release/3/13 is 6 hours ago:=C2=A0<=
a href=3D"https://app.readthedocs.org/projects/gdal/">https://app.readthedo=
cs.org/projects/gdal/</a> e.g. for these:</div><div><br></div><div><a href=
=3D"https://gdal.org/en/latest/">https://gdal.org/en/latest/</a></div><div>=
<a href=3D"https://gdal.org/en/stable/">https://gdal.org/en/stable/</a></di=
v><div><a href=3D"https://gdal.org/en/release-3.13/">https://gdal.org/en/re=
lease-3.13/</a></div><div><br></div><div>Do I have any of that correct and =
what is the semantic=C2=A0meaning of the &quot;stable&quot; branch that use=
rs should read into it?</div><div><br></div><div>Thanks!</div><div>-Kurt</d=
iv></div>

--0000000000009b48260655188d94--

--===============2758428020643857114==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

_______________________________________________
gdal-dev mailing list
[email protected]
https://lists.osgeo.org/mailman/listinfo/gdal-dev

--===============2758428020643857114==--