Version numbers in the guide

Jesper Wilhelmsson jesper.wilhelmsson at oracle.com
Thu May 21 04:02:51 UTC 2020


Hi.

I have been thinking about the version numbers and the release notes in the guide; do we really need that part?

Who are the audience for this information?

To me, today, these numbers and notes only creates extra work and I don't see any real benefit in having them. If I want to see when or why some part of the guide changed I wouldn't trust the release notes anyway as they are way too coarse - I would go to the change log on Github.

Release notes like these are always subject to subjective opinions on what is an important change and what is not, and unless pretty much every change is included someone has to make a decision for each change wether to include it or not.

/Jesper



More information about the guide-dev mailing list