Hacker News new | past | comments | ask | show | jobs | submit login

> For example here's a release announcement I wrote recently: https://www.redhat.com/archives/libguestfs/2020-February/msg....

Request to please start release announcements by saying what really a "Network Block Device (NBD) server" is. Don't assume that people are familiar with every possible piece of software already.




This is a fair point. I think earlier versions did try to explain what NBD is but they were a bit wordy, and just expanding NBD was deemed sufficient. Next time I'll see if I can get that better.

Of course there's a level beyond which you don't really need to go - I wouldn't suggest explaining what Linux is or what software is.


Frankly my reply was just rhetoric, and I don't like the suggestion of explaining the base of things in release notes. If someone is interested enough they would care to look it up. Those who are not interested would skip the notes anyways.

Release notes are usually for people who are already using it.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: