From 6053d313ce3abe876c7d05574effab438ce5e410 Mon Sep 17 00:00:00 2001 From: Zhiming Wang Date: Fri, 8 Jan 2016 11:21:54 -0800 Subject: Markdown source files: Use ... to end YAML metadata block Also add a newline after the metadata block. ... is easier on markdown-mode; if --- is used, the line immediately above it will be treated as a setext header and highlighted, which isn't so easy on the eyes. --- .../blog/2015-10-12-the-importance-of-dated-detailed-release-notes.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (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 index 4ca7ddbd..2d0b977b 100644 --- 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 @@ -2,7 +2,8 @@ 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: -- cgit v1.2.1