3 ms·
Many moons ago after having long criticised shortcomings of a reasonably popular system,[1] I finally arrived at a moment of enlightenment: It is a simple tool
by dredmorbius 3y ago
Many moons ago after having long criticised shortcomings of a reasonably popular system,[1] I finally arrived at a moment of enlightenment:
It is a simple tool, accessible to many, which is useful for simple tasks.
The chief architect of the system didn't comment on the note, but did as he frequently did with various critiques of mine, indicate having seen it.
Markdown fits this description, and really should be considered on those grounds. And it's suitable for documents of often surprising complexity.
Manpages are a specific document type, which have co-evolved with a specific document processor. I've used that processor, and even, whilst at uni, wrote term papers using it. I've forgotten virtually all that knowledge: roff(1) and kin are obscure and complicated. They're also not especially human-readable, in ways that Markdown, other lightweight markup languages, HTML, LaTeX, and DocBook, say, are.
See also: <https://www.dreamsongs.com/WorseIsBetter.html https://www.dreamsongs.com/WorseIsBetter.html> (HN discussion: <https://news.ycombinator.com/item?id=8449680 https://news.ycombinator.com/item?id=8449680>)
________________________________
Notes:
1. Google+, as it happens. Which had its own bastardised and painfully limited markup notation. And no, it didn't kill FB, but it was used extensively by tens of millions.