From ef050ecd016451e34997ffb8e04156709a128c41 Mon Sep 17 00:00:00 2001 From: Zhiming Wang Date: Mon, 12 Oct 2015 14:29:22 -0700 Subject: 20151012 The importance of dated, detailed release notes --- ...e-importance-of-dated-detailed-release-notes.md | 26 ++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 source/blog/2015-10-12-the-importance-of-dated-detailed-release-notes.md (limited to 'source/blog/2015-10-12-the-importance-of-dated-detailed-release-notes.md') diff --git a/source/blog/2015-10-12-the-importance-of-dated-detailed-release-notes.md b/source/blog/2015-10-12-the-importance-of-dated-detailed-release-notes.md new file mode 100644 index 00000000..4ca7ddbd --- /dev/null +++ b/source/blog/2015-10-12-the-importance-of-dated-detailed-release-notes.md @@ -0,0 +1,26 @@ +--- +title: "The importance of dated, detailed release notes" +date: 2015-10-12T14:29:42-07:00 +date_display: October 12, 2015 +--- +I can't stress how much I value release notes, especially for closed source, commercial software. None of us want to invest on a piece of abandonware (unless it is ageless, which is quite unlikely for anything with a GUI), or a piece of software that is not completely abandoned, but takes a full year to adapt to the latest OS, campatibility-wise or UI-wise; and release notes, especially with dates, serve as almost the single metric for gauging developer commitment. In fact, whenever I try to learn about a piece of software that I heard about, one of the first things I do, usually after browsing through features and screenshots and before I even download the software to try out, is to look for its release notes and skim through it if available, and the outcome largely determines whether I'll even bother to download the installer.[^cask] A prominent, dedicated page with dated, detailed release notes immediately leaves a good impression on me. + +Unfortunately, many developers or publishers don't value release notes as much as I do. Several problems, in ascending order of seriousness: + +* Most release notes are not linked to from the home page or at least the download page, which kind of makes sense when the audience is generally non-technical, but there's little excuse when the software's targeted audience are pro-level or power users. This is not a big problem now because Google is very good at turning up release notes as long as they exist. + +* Quite some release notes are not dated, which I can't understand — it's so easy to date each entry, and it adds so much context, especially for gauging commitment (I guess developers who are less commited might not want to insert dates precisely for this reason). + +* For some software, releases notes are downright nonexistent, at least not on the web. Interestingly, occasionally they are available from an in-app menu or distributed document; the publishers just don't bother to put it on a web page. Not surprisingly, I might as well not bother to download this kind of software.[^download] + +If I were ever to publish closed source software, I'll definitely have dated, detailed release notes, linked to from the home page. + +--- + +P.S. Speaking of release notes, it's hard not to complain about MAS, as if there are not enough complaints about this horrible platform. You can only view the most recent release with its release notes (and some publishers stack "bug fixes" notes of minor/patch releases on top of the real notes of the last major release, making it ever more confusing), whereas in the iOS App Store you have the "Version History" page that shows you a dated list of releases with release notes — what I would expect from everywhere. Basically, Apple has all this data and they can show it to you in a satisfactory way it they want to, but they blew it by not bothering to implement it. Note that I'm much more likely to care about the release notes of an OS X application than an iOS app, and I daresay most power users will agree with me. + +Of course there are much more serious problems with MAS like the lack of trials, so the release notes problem is nothing but an insult over injury. In short, MAS is not a good distribution channel; it's only a lazy one, a compromise for small publishers. + +[^cask]: Nowadays, with homebrew-cask, I'm much more likely to give things a spin, but still, I take an especially defensive stance against anything that doesn't have release notes. + +[^download]: Yes, I won't deny that downloaded some of them nevertheless — that's how I found out. -- cgit v1.2.1