As I quite often use the:
command, I notice that many of the entries are:Code:man command
a) not newb-friendly
b) not friendly (full stop)
d) Heavy and not useful because of that.
I would very much like to help improve some of these manpages, but:
1. How? I have tried a google search, but nothing.
2. Is there a markup language or programming language I need to learn?
3. Am I allowed to? Or is the manpage written by the dev only?
4. Would a very user-friendly manual; i.e. extended to perhaps twice the length it needs to be for greater clarity be welcomed by the majority of users? Or would I be better writing some other form of documentation instead?
No disservice to the devs, I program myself. Writing a README that doesn't irritate, but does provide clear instructions is a nightmare.