Hacker News Reader

Strong agree on the lack of a decent definition list notation. Strong agree on roff. Moderately strong on most of his critique Pretty strong disagree that markdown is an abominably bad choice: it's problems are fixable.

A single canonical reference and a little restraint and a dl definition would do it for me, regarding man page creation.

View on HN

>A single canonical reference

https://commonmark.org/

(2014 updated 2021) the original OpenBSD article is (2017) and there's still no good canonical DL instantiation -commonmark goes into "do it in HTML" which is .. FAIL in my book.

So, a "standard" which has been continuously revised since 2014 and doesn't have definition lists except as "use HTML"

That was the best attempt to update it and improve upon it.

Its mostly successful, but not entirely. Wish Gruber would just link to that instead of his old, bugger, out of date spec.

Reply on news.ycombinator.com