As someone who's written a few well known man pages: that's awesome. The 'troff' format is pretty long in the tooth now.
Most Linux man pages are pretty poor quality: for a long time the the upstream Linux maintainer refused to accept any changes eg, adding an EXAMPLES section for cron tables - because Paul Vixie (the cron author) 'might not like them'. Forking man-pages , using markdown as a source format and allowing pull requests would help a lot.
1 comment
[ 3.1 ms ] story [ 9.3 ms ] threadMost Linux man pages are pretty poor quality: for a long time the the upstream Linux maintainer refused to accept any changes eg, adding an EXAMPLES section for cron tables - because Paul Vixie (the cron author) 'might not like them'. Forking man-pages , using markdown as a source format and allowing pull requests would help a lot.