←back to thread

How to Write Compelling Release Announcements

(refactoringenglish.com)
69 points mtlynch | 1 comments | 25 Jun 25 14:22 UTC | HN request time: 0.242s | source
Show context
mtlynch ◴[25 Jun 25 14:23 UTC] No.44377670[source]▶
Author here. Happy to take any feedback or questions about this post.
replies(2): >>44377986 #>>44379115 #
MOARDONGZPLZ ◴[25 Jun 25 14:48 UTC] No.44377986[source]▶
I read the whole thing and didn't know what a release announcement was until the section where you pointed to "real world examples," which linked to elsewhere. I did pick up from your text that they are not the same as release notes though. Could I suggest you succinctly define what you consider to be a release announcement at the outset?
replies(1): >>44378229 #
1. mtlynch ◴[25 Jun 25 15:08 UTC] No.44378229[source]▶
Thanks for reading! That's great feedback.

Do you feel like this would be a helpful definition to include at the top?

>A release announcement is a summary of the changes that will have the greatest impact on the user's experience. It presents them in a clear, accessible way that focuses on the user.