<div dir="ltr"><div dir="ltr">On Tue, May 9, 2023 at 8:17 AM George Joseph <<a href="mailto:gjoseph@sangoma.com">gjoseph@sangoma.com</a>> wrote:<br></div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, May 9, 2023 at 3:07 AM Joshua C. Colp <<a href="mailto:jcolp@sangoma.com" target="_blank">jcolp@sangoma.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div dir="ltr">On Mon, May 8, 2023 at 8:47 PM George Joseph <<a href="mailto:gjoseph@sangoma.com" target="_blank">gjoseph@sangoma.com</a>> wrote:<br></div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr">Thinking of a few things...<div><br></div><div>Look at...</div><div><a href="https://downloads.asterisk.org/pub/telephony/asterisk/ChangeLog-18.18.0-rc1.md" target="_blank">https://downloads.asterisk.org/pub/telephony/asterisk/ChangeLog-18.18.0-rc1.md</a><br></div><div>This file is WAY too big (over 700 lines) because it contains the full commit descriptions.  I'm thinking of shortening it down to be the same as the email announcements.  If you really want the details, you should be doing a `git log` anyway.<br></div></div></blockquote><div><br></div><div>I disagree on the use of "git log" because that is thinking about this from the perspective of a developer, not a user/deployer of Asterisk. They may not even have git or have checked Asterisk out from git. I think it's perfectly fine and even valuable for the ChangeLog to contain the full commit description. The announcement provides high level, if you're interested in more then you go to the ChangeLog. Why is it a problem?</div></div></div></blockquote><div><br></div><div>Just seemed overkill but you're right. It'll stay.</div><div> <br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div class="gmail_quote"><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div></div><div><br></div><div>Check out 'releases/18' or 'releases/20'.</div><div>First, I forgot to add the specific change log for the release (<a href="http://ChangeLog-18.18.0-rc1.md" target="_blank">ChangeLog-18.18.0-rc1.md</a>).  I'll fix that before releasing 18.18.0/<a href="http://20.3.0." target="_blank">20.3.0.</a>  </div><div>Second, I should NOT have updated the ChangeLog and CHANGES files in the tarballs for release candidates.  I'll be backing those updates out.</div><div>And speaking of ChangeLog and CHANGES... 'ChangeLog' has the full commit description for every commit since August 2013 (over 100K lines) and the CHANGES file has the highlights for every release since version 1.4.  Because we always have multiple simultaneous releases in process, the files have large time/release gaps in them and aren't accurate.  They're also a pain to maintain.  Do we really need to keep them?  Going forward they're both just going to have the new release-specific ChangeLogs prepended to them anyway.</div><div><br></div><div>Thoughts?<br></div></div></blockquote><div><br></div><div>The ChangeLog and CHANGES files probably not. Personally I just use them as an easier way to build up a first draft of what's gone on over the past year.</div></div><div><br></div></div></blockquote><div><br></div><div>We could create a ChangeLogs directory in the releases branches that simply has the change log for each release added to it.  That way the release process can add <a href="http://ChangeLog-18.18.0-rc1.md" target="_blank">ChangeLog-18.18.0-rc1.md</a> which would have the changes since 18.17.1, then ChangeLog-18.18.0-rc2 which would have  changes since rc1, etc.  Then when 18.18.0 GA is cut, it can add ChangeLog-18.18.0 with changes since 18.17.1 and delete the intervening RCs.<br></div></div></div></blockquote><div><br></div><div>That'd be dandy.</div></div><div><br></div><span class="gmail_signature_prefix">-- </span><br><div dir="ltr" class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div style="font-family:tahoma,sans-serif"><font color="#073763">Joshua C. Colp</font></div><div style="font-family:tahoma,sans-serif"><font color="#073763">Asterisk Project Lead</font></div><div style="font-family:tahoma,sans-serif"><font color="#073763">Sangoma Technologies</font></div><div style="font-family:tahoma,sans-serif"><font color="#073763">Check us out at <a href="http://www.sangoma.com" target="_blank">www.sangoma.com</a> and <a href="http://www.asterisk.org" target="_blank">www.asterisk.org</a></font><br></div></div></div></div></div></div></div></div></div></div></div>