Eugen Rochko
I gotta start writing the hype-oriented 2.6.0 announcement post
Oct 29, 2018 at 4:32amWeb
Show threadEugen RochkoOct 29, 2018

Honestly I'm always a bit struggling with which audience those blog posts should have in mind. There's like three types of changelogs I have to write: the point by point changelog included in the source files, the GitHub release changelog, which sysadmins will read to figure out how to upgrade and why to upgrade, and these hype-oriented blog posts.

But if I'm not aiming at sysadmins there, does it mean I should omit writing about admin features, CLI utilities, fixes and all that stuff 🤔

Show threadEugen RochkoOct 29, 2018
Outline 
Show threadBen Lubar (any pronouns)Oct 29, 2018
@Gargron no update note Mastodon will ever have will beat Dwarf Fortress's "stopped dogs from being depressed because they couldn't figure out how to practice their religion" or "fixed a bug where cats would die from alcohol poisoning if they walked into a tavern"
Show threadJustin MichaelOct 29, 2018
@Gargron Doesn't this release have the API additions to make saving your place in third party apps viable? If so, that should be in there somewhere to entice/encourage developers.
Show threadDag Ågren ↙︎↙︎↙︎Oct 29, 2018
@Gargron Is preview data embedded in the stream JSON now?
Show threadEugen RochkoOct 29, 2018
@WAHa_06x36 yea
Show threadDag Ågren ↙︎↙︎↙︎Oct 29, 2018
@Gargron Niiiiice. Going to have to get on with implementing that! Also go to sleep!
Show threadinfinite love â´³Oct 29, 2018
@Gargron no, don't omit it. it's still important to know "hey btw admins have an easier time now" and maybe some of the popular audience might be interested in admining their own instance down the road. a simple point-by-point of "hey these are some of the new changes that make it easier on admins" is enough.
Show threadNeal Wilson ✅Oct 29, 2018
@Gargron It's okay to hype admins about upgrading.
Show threadapattersOct 29, 2018
@Gargron This might like it's coming from left field, but I would target the media. If the end goal is growth then the media can be your biggest ally (or enemy).
Technical notes for developers and sysadmins are critical as well but don't have to be in the big announcement post (and you probably have enough trusted contributors by now that you can start to delegate these).
Show threadKevin MarksOct 29, 2018
@Gargron If you want an extra pair of eyes on the rel=me stuff I'm very happy to help. The best writing advice on. release notes is Anna's at Slack: https://slackhq.com/a-little-thing-about-release-notes
A little thing about release notes | The Official Slack Blog

Why they’re important to us, and how we approach the writing of them at Slack

Several People Are Typing
Show threadTyler!Oct 29, 2018
@Gargron Different industry (writing and game design) but have a similar problem. Do consumers care about our behind the scenes stuff? Do Game designers care about our consumer focused stuff? Tricky wicket.