"In the GNU project, man pages are secondary. [..] It’s your choice whether to include a man page in your program. [..] consider that supporting a man page requires continual effort each time the program is changed. The time you spend on the man page is time taken away from more useful work."
MORE USEFUL WORK?!?!!!!
I can't think of much in our IT world that is more useful that good and accurate documentation.
https://www.gnu.org/prep/standards/html_node/Man-Pages.html
(h/t giulianopz)
JP Mens /
npub1gs…aju3v
2024-10-16 08:36:02
Author Public Key
npub1gss7d7840hekue3lrfzksdzpjmnpaf3wh9pq8jwq9kpmevltn3nq8aju3vPublished at
2024-10-16 08:36:02Event JSON
{
"id": "9a6e9f4648f883d88981915f716bb5ee0e3132d3d7b6a955bad78ad30aa60482",
"pubkey": "4421e6f8f57df36e663f1a4568344196e61ea62eb94203c9c02d83bcb3eb9c66",
"created_at": 1729067762,
"kind": 1,
"tags": [
[
"proxy",
"https://mastodon.social/users/jpmens/statuses/113316184894055901",
"activitypub"
]
],
"content": "\"In the GNU project, man pages are secondary. [..] It’s your choice whether to include a man page in your program. [..] consider that supporting a man page requires continual effort each time the program is changed. The time you spend on the man page is time taken away from more useful work.\"\n\nMORE USEFUL WORK?!?!!!!\n\nI can't think of much in our IT world that is more useful that good and accurate documentation. \n\nhttps://www.gnu.org/prep/standards/html_node/Man-Pages.html\n\n(h/t giulianopz)",
"sig": "3291f1f9297393acb98567909ec20a61ea548947710b26dd220e4a786f2716b71b01b13ba7956d3796e87df1cf69bceb05da93f490077f1dcd45823f0baf6c65"
}