Rails 5.1.0 Beta 1
These release notes <i>really</i> let Rails down. Crowing on about the number of commits and rationalising decisions is a waste of my time, just explain how it's going to make or ruin my day. Links you'd expect to explain features just take you to source files, not documentation. And a HUGE amount of the changes are actually scattered around in sub-project changelogs.<p>They should look at Django for some inspiration. Here's their latest beta release notes [1]. It's concise, <i>everything</i> links to relevant documentation with examples, and the entire project's changes are handled on the one page. There's even a list of things to check if you're upgrading.<p>[1]: <a href="https://docs.djangoproject.com/en/dev/releases/1.11/" rel="nofollow">https://docs.djangoproject.com/en/dev/releases/1.11/</a>