Want to read Slashdot from your mobile device? Point it at m.slashdot.org and keep reading!


Forgot your password?

Submission + - The Strange Art of Writing Release Notes (ieee.org) 1

necro81 writes: IEEE Spectrum has an amusing piece on how App Stores, and the frequent updates to those apps, have given release notes new prominence to average users. Unfortunately, most release notes are hum drum and uninformative: "bug fixes, performance improvements." That may be accurate, but isn't useful for determining if the new version is worth downloading. The article highlights counterexamples that weave humor and creativity into the narrative, even if it still just boils down to "bug fixes". For instance, when was the last time your release notes included ASCII art?

Although a bit old, TechCrunch also has a commentary on the highs and lows of App Store release notes.

What is the opinion of /. users? How much information is appropriate in release notes? Should one make any attempts at levity, or keep it strictly to business? For those of you who actually write release notes, what guidelines do you use?

This discussion was created for logged-in users only, but now has been archived. No new comments can be posted.

The Strange Art of Writing Release Notes

Comments Filter:
  • Writing them at all is a milestone, when it comes to small or in-house updates.

    Next, consider what YOU would like to know, if you were reading them for into.

    Finally, I suggest adopting a consistent style, or make a template, because you'll surely right more than one.

"When people are least sure, they are often most dogmatic." -- John Kenneth Galbraith