Re:TLDR pages: Simplified, community-driven man pages
by fluidcruft on Wednesday January 22, 2020 @12:18PM
(#22119603)
Doesn't GNU still scoff at man pages and foist texinfo? Honestly who wants to waste their time with roff etc?
The focus has been making it easier for the developers to write literally anything. One thing uses sphynx another uses man another uses doxygen or what the hell ever. Users aren't developers. This is why everyone ends up on google and ends up on stackoverflow or random blog or watching youtube.
The barrier to entry is much lower with some simple markdown thing. Hell, I was thinking about how to abuse this thing to make my own notes about commands.
Re:TLDR pages: Simplified, community-driven man pages
by aktau on Wednesday January 22, 2020 @02:38PM
(#22121179)
I maintain my man pages in markdown format, and convert them to roff at build time. There are plenty of tools that can do that: pandoc(1), ronn(1), ...
The focus has been making it easier for the developers to write literally anything. One thing uses sphynx another uses man another uses doxygen or what the hell ever. Users aren't developers. This is why everyone ends up on google and ends up on stackoverflow or random blog or watching youtube.
The barrier to entry is much lower with some simple markdown thing. Hell, I was thinking about how to abuse this thing to make my own notes about commands.