Ask HN: How do you handle release notes for non-technical users?
1–7 of 7 posts
Re: Ask HN: How do you handle release notes for non-technical users?
#2What I absolutely hate is the generic release note that seemed to come about with agile release schedules. Notes like, “bug fixes and performance improvements”, “Thanks for using , we make regular improvements to ensure your experience is top notch”, or “We update our app often to .”
This tells me nothing and makes me less likely to bother reading any release notes at all.
Re: Ask HN: How do you handle release notes for non-technical users?
#3As a user, I like release notes that tell me new features exists that I can explore, and/or tell me which user-facing bugs were fixed, so I can try using the feature again that I’ve been avoiding. What I absolutely hate is the generic release note that seemed to come about with agile release schedules. Notes like, “bug fixes and performance improvements”, “Thanks for using , we make regular improvements to ensure you…
This will keep existing users on the app for longer. If you're a project manager or manage an app, this is definitely something you should care about.
Also, I'm trying something out here because I saw a loophole, let's see how it goes :)
Re: Ask HN: How do you handle release notes for non-technical users?
#4As a user, I like release notes that tell me new features exists that I can explore, and/or tell me which user-facing bugs were fixed, so I can try using the feature again that I’ve been avoiding. What I absolutely hate is the generic release note that seemed to come about with agile release schedules. Notes like, “bug fixes and performance improvements”, “Thanks for using , we make regular improvements to ensure you…
I use release notes to help me decide whether not to update to the new release. I would prefer that no release note is made at all over that kind of thing. At least that's being honest about not wanting to say what the changes were.
Re: Ask HN: How do you handle release notes for non-technical users?
#5As a user, I like release notes that tell me new features exists that I can explore, and/or tell me which user-facing bugs were fixed, so I can try using the feature again that I’ve been avoiding. What I absolutely hate is the generic release note that seemed to come about with agile release schedules. Notes like, “bug fixes and performance improvements”, “Thanks for using , we make regular improvements to ensure you…
I couldn't agree more. Release notes like that are informationally identical to a release note that just says "New release." I use release notes to help me decide whether not to update to the new release. I would prefer that no release note is made at all over that kind of thing. At least that's being honest about not wanting to say what the changes were.
Re: Ask HN: How do you handle release notes for non-technical users?
#6Earlier quoted context omitted.
I couldn't agree more. Release notes like that are informationally identical to a release note that just says "New release." I use release notes to help me decide whether not to update to the new release. I would prefer that no release note is made at all over that kind of thing. At least that's being honest about not wanting to say what the changes were.
But what if that release really only included bug fixes and speed improvements?
Re: Ask HN: How do you handle release notes for non-technical users?
#7Earlier quoted context omitted.
I couldn't agree more. Release notes like that are informationally identical to a release note that just says "New release." I use release notes to help me decide whether not to update to the new release. I would prefer that no release note is made at all over that kind of thing. At least that's being honest about not wanting to say what the changes were.
But what if that release really only included bug fixes and speed improvements?