Re: Old style - detailed Release notes

On 2025-08-04 09:50, Amish wrote:

> I recall that earlier whenever there was a new squid major release, 
> there used to be release notes found on downloads page.

You can find release notes in bootstrapped Squid sources linked from 
GitHub releases page[1]. For example, for Squid v7.1, that file is 
called squid-7.1/doc/release-notes/release-7.html (and it can be found 
inside squid-7.1.tar.bz2 archive provided at [1]). A copy of that file 
is also available in the same archive as squid-7.1/RELEASENOTES.html.

We could provide that file as a stand-alone release artifact, linked 
from every release on [1], but I am worried about increasing noise and 
sliding down the slippery slope -- there are other files in archives 
that others may find useful, and each will be increasingly difficult to 
locate as we add them as stand-alone artifacts...

That HTML file is generated so it is not found in the source code 
repository. That should change when we switch from SGML to Markdown (and 
require some automated post-processing/indexing at commit time). When 
that happens, we could easily add the corresponding link to our release 
descriptions at [1] AFAICT.


HTH,

Alex.
[1] https://github.com/squid-cache/squid/releases


> This release notes used to provide section wise details of changes from 
> previous major version.
> 
> Like What's new, What directive is deprecated / removed, What directive 
> is replaced / changed.
> 
> And it used to be extremely helpful to upgrade from one major version to 
> another.
> 
> We could just refer to it and change our squid.conf accordingly. And 
> also make use of some new features added to new version.
> 
> However ever since migration to Github, I can not find such a release 
> notes.
> 
> Github release page does not arrange the change log in section wise 
> manner like earlier.
> 
> If such a release notes still exists then can you please provide link to 
> it? I am sorry if I completely overlooked it.
> 
> Or if not then can such release notes be provided for easy reference?
> 
> Thank you
> 
> Amish
> 
> _______________________________________________
> squid-users mailing list
> [email protected]
> https://lists.squid-cache.org/listinfo/squid-users