News for hackers. Stuff that matters.
Re:Practical Unix Manuals: mdoc by clort on Sunday November 26, 2017 @01:36PM (#15782273)
> I love man pages they are often easy to read, but roff is not that easy to author

To be fair, writing the programs or functions that the manual page is purporting to document isn't easy either. I have written manpages (and plenty of code) and in my experience, the hardest part is not the markup but getting the actual content right.

Re:Practical Unix Manuals: mdoc by emj on Tuesday November 28, 2017 @08:40PM (#15803731)
There are badly written documentation out there, and they will not be better just because they are formated as a man page instead of Microsoft Word, but the worst kind are the ones which are never written and that syntax is quite a blocker. Your comment highlights my bias for man pages, I forgive a lot more when it's read in prefered format rather than .docs.