Simple release notes were funny a decade+ ago when I first saw one. Now they are annoying. Why not write “Small fixes and improvements, and yes despite the apparent slow pace of development we really do have full time developers working on this product.”
Whenever a colleague retires I always ask if I can use their name as a pseudonym in all my comments for the next year. I have had the good fortune to work with a couple colleagues who, like Euler, continued to publish well after their passing.
I agree. Why don’t companies have a link where the publish more in depth release notes. The under the hood changes might be something my specific trainer is suffering from.
Most release notes could just say
Fixed some bug
Introduced some new ones. These will be fixed in the next release
In their market it would be very easy to give away details that a competitor app could leverage, so playing the “vague” approach is safe I guess. I would hope however that if there was any significant reason to add specific details, eg, security related, that TR would call it out.
Depending on the length of the dev/release cycle a complete set of change notes might be huge but having a link to a release notes page takes care of that. There’s also changes to commercially sensitive code that a company almost certainly won’t want to divulge.
That said, something like:
fixed issue where user survey was only presented after checking for adaptations.
Doesn’t divulge any sensitive info whilst actually stating what’s been fixed.
TR use libraries like React so there’s a good chance that there are changes associated with updates to those.
This would also be extremely helpful if you’ve reported an issue to know if it’s fixed in a specific release. The other way I’ve seen this done is to say the release fixes specific issues, and just list the issue number. But this would require TR support to give people issue numbers when they report problems
When you raise a problem with support you get a reference number but the chances are that it doesn’t refer to a bug number in the bug tracking system or a commit in a version control software like Git.
Good to hear, from my point-of-view its quid pro quo. When I take the time to carefully document and submit an issue, I expect my vendor to take the time to document fixes. All of the software developers I talk with use a system like Jira to track issues, and that makes producing release notes fairly easy.