|
|
Subscribe / Log in / New account

A "joke" in the glibc manual

A "joke" in the glibc manual

Posted Nov 9, 2018 1:54 UTC (Fri) by mjg59 (subscriber, #23239)
In reply to: A "joke" in the glibc manual by neilbrown
Parent article: A "joke" in the glibc manual

So "I would like to change this document in order to ensure that the communication it embodies is kinder" is fine?


to post comments

A "joke" in the glibc manual

Posted Nov 9, 2018 5:13 UTC (Fri) by neilbrown (subscriber, #359) [Link] (1 responses)

I think that is much better, yes.
It takes ownership of the opinion, and declares an intention and desire to follow a particular path that is known to be welcome, without suggesting that anyone else is required to make the same choice.
If someone has a different position, that need not be seen, in itself, as contradicting the guidelines.
The guidelines guide your conduct, but do not resolve your disagreements - you still need to do that yourself.

BTW, while rereading the guidelines I noticed "If other participants complain about the way you express your ideas, please make an effort to cater to them." and wanted to thank you for making the effort. I think that is really valuable, and it is appreciated.

A "joke" in the glibc manual

Posted Nov 15, 2018 18:21 UTC (Thu) by Wol (subscriber, #4433) [Link]

> It takes ownership of the opinion, and declares an intention and desire to follow a particular path that is known to be welcome, without suggesting that anyone else is required to make the same choice.

Which is why the linux raid wiki editing guidelines state pretty much "please write in the *first* person and take *personal* responsibility for what you write".

Imho there's far too much emphasis on third-person impersonal writing that takes responsibility for nothing. (Plus 1st-person is much nicer to read :-)

Cheers,
Wol


Copyright © 2025, Eklektix, Inc.
Comments and public postings are copyrighted by their creators.
Linux is a registered trademark of Linus Torvalds