search

sopel-irc / sopel

:robot::speech_balloon: An easy-to-use and highly extensible IRC Bot framework. Formerly Willie.
https://sopel.chat
Other
951 stars 405 forks source link

8.0.0 changelog #2600

Closed dgw closed 2 months ago

dgw commented 3 months ago

Since I only wanted to work on this if I could do a whole page of 25 PRs in one sitting, it sometimes took over a week between sessions. So here we are in March despite me starting on this in earnest two months ago.

I don't know how far along @SnoopJ has gotten with putting feedback on sopel-irc/sopel.chat#46 but this and that should probably be reviewed somewhat together. The changelog (this) summarizes the highlights, and the upgrade guide (that) gives all the details with suggested replacements for deprecated/removed features.

This will be a lesson for future changelogs, and we're going to have an 8.1-NEWS, 9.0-NEWS, etc. branch for the next releases. I've learned that the way we did it for 7.0.0 was Good, Actually!

And yes, I am very very tempted to add this PR itself to the changelog. We like being meta around here, right?

dgw commented 2 months ago

Since we decided (on IRC a few weeks ago) that any omissions in the upgrade guide can be fixed later, it's not that much different to treat omissions or errors in the changelog the same way. Anyone referring to the changelog later is welcome to point out broken or mixed-up links, etc. in lieu of getting a second line-by-line review here and now.

The website can be updated without needing to upload a new version, but we also have the option for post releases if any significant mistake can't wait until the next patch release to be included in the distribution.