Changing the world with better documentation
Changing the world with better documentation
Posted Jan 29, 2019 15:54 UTC (Tue) by mathstuf (subscriber, #69389)In reply to: Changing the world with better documentation by nilsmeyer
Parent article: Changing the world with better documentation
I don't have that anxiety (well, any more than just making public posts already has). I don't think one needs to proactively think of all ways something might be taken as any of unprofessional, inconsiderate, or offensive. As long as you're receptive to those who say it's a problem (publicly or privately) and respond that you're sorry (at least privately, but a public reply is good as well) and understand that what you've said could have been stated better and that you learn from the experience and improve future behavior I think that you'll be fine. It's always a learning process. I don't have first hand experience for what it's like to experience things from various other views (be it racial, nationality, gender issues, etc.) and I don't have the presumption that I'd be able to figure it out on my own not being part of all groups. But, I can learn from others and from my own mistakes and improve my communication that way.
Posted Jan 29, 2019 15:57 UTC (Tue)
by nilsmeyer (guest, #122604)
[Link] (30 responses)
Posted Jan 29, 2019 16:09 UTC (Tue)
by mathstuf (subscriber, #69389)
[Link] (29 responses)
Posted Jan 30, 2019 14:09 UTC (Wed)
by codeofdrama (guest, #127444)
[Link] (12 responses)
Posted Jan 30, 2019 16:20 UTC (Wed)
by nix (subscriber, #2304)
[Link]
Posted Jan 30, 2019 19:03 UTC (Wed)
by mathstuf (subscriber, #69389)
[Link]
- I have a few patches in the kernel and maybe a few in fd.o projects, but am not otherwise involved;
> To what extend do you think, that the allegation has merrit?
The thread was civil until the message by hch being called out started implying that the others were lazy rather than disagreeing on technical merits.
> What parts of the codes of conducts does the allegation refer to?
I'd classify it as ad hominem in general. As for CoC references:
Kernel CoC: "Being respectful of differing viewpoints and experiences". There's a technical disagreement of which I can't argue to the merits of, but calling someone lazy is at least not respecting viewpoints. Likely empathy as also slipped a little. fd.o's CoC is largely the same AFAICS.
> To what extend do you think, that the language of the allegation itself violates the codes of conduct?
I assume you're referring to this part:
> if you still can't participate in reasonable discussion like an adult
since I don't see anything remotely at issue with the rest of it. This is not on the same level as the called out behavior, but still not how I think I'd have worded it exactly. The outburst was implying that the others are being lazy for not doing some action. This is a call out to a single instance of behavior being childish (it could have been worded more precisely I think). It's the difference between "that's an asshole thing to do" vs. "you're an asshole". The former (to me; non-native speakers may have different readings) implies that improvement is there by changing one's actions whereas the second is concluding something about the person and that there isn't a(n easy) way to fix something.
I don't know of hch's prior behavior (if any), but in isolation, I probably would have called out the outburst (possibly privately), referencing the CoC, but not "threatening" with it…which is what I see done here. Acknowledgement from hch would be nice to see, but private communication would also likely suffice. I can sympathize with hch on the frustration part, but the right solution is not to imply that other developers are being lazy, but to do as Daniel suggests: take a bit of time to calm down before replying. Maybe better technical details would work, but again, there's obviously some misunderstanding on a technical level here, but it's beyond my personal experience.
> Is there proper a place, and way to challenge allegations?
For reporting behavior, the kernel CoC mentions <conduct@kernel.org> and fd.o mentions 3 email addresses as well as a list. It being private makes it hard to reply to allegations. I don't see evidence that this thread was elevated to an official report (though the callout was from a member of fd.o's conduct team), so I don't know what there is to officially challenge in this instance. But…
> Is this an opportunity to improve the Linux kernel code of conduct?
Absolutely. Every interaction with it is an opportunity to improve it. No different than computer code, law, personal relationships, among many other things in life.
Posted Jan 30, 2019 20:17 UTC (Wed)
by rgmoore (✭ supporter ✭, #75)
[Link] (9 responses)
I think you haven't noticed what's missing from this post: a mention of reporting the comment in question as a violation of the CoC. This is an informal attempt by a peer to bring the conversation back to a more productive tack, with the CoC used as an authoritative reference for what's acceptable. This kind of community enforcement of norms is exactly the way things ought to work; when somebody goes overboard and uses language they shouldn't, the first resort should be other people telling them they're out of line. Formal enforcement should be reserved for cases where that kind of feedback is ineffective.
Posted Jan 31, 2019 5:10 UTC (Thu)
by neilbrown (subscriber, #359)
[Link] (8 responses)
It is, but I'd suggest that it is a fairly poor attempt. It comes across, to me, as somewhat heavy-handed and bossy, which isn't very far from the problem with the original.
For reference, the original from Christoph (hch) says:
> That is a bullshit attitude. Just like everyone else makes their
which is blunt, terse, crude, and insulting.
The response given by Daniel Stone starts:
> Can you not talk to people like that?
This is poorly constructed. Christoph certainly can "not talk to people like that", but he chooses otherwise. I know what Daniel means, but his meaning is different to what the words say. Ambiguity is always best avoided, most particularly when there is disagreement.
> Please don't talk to people like that.
or even
> I agree in principal, but think the message would be clearer if stated more politely.
or any number of options are that polite, unambiguous, and (ideally) helpful.
He continues:
> I have absolutely no idea how you can look at the work the AMD people have put in over many years and conclude that they're 'lazy'.
This seems to me to be a misunderstanding. Christoph is not accusing the whole team of laziness over an extended period. He is accusing a specific developer (possibly extending to an immediate team) of a single instance of laziness.
When someone has behaved poorly, accusing them of a much larger offense is a common tactic, but not a wise or helpful one. I don't know that it was deliberate on Daniel's part in this case, but it certainly weakens his case.
Daniel continues (I skip various bits):
> and if you still can't participate in reasonable discussion like an adult
Here Daniel effectively accuses Christoph of acting like a child, which seems to me to be roughly on par with Christoph accusing others of being lazy. When trying to help someone correct their behavior, it is not wise to emulate that behavior in the process.
If I were in Christoph's position, I would have little difficulty shrugging this off as an ignorant response - which is unfortunate because I think Daniel was right to respond and should be commended and encouraged.
I would recommend:
Posted Jan 31, 2019 11:51 UTC (Thu)
by nilsmeyer (guest, #122604)
[Link] (7 responses)
This seems to be the only instance of Daniel participating in the thread, I think it's also poor form to step in on someone else's behalf without giving Christian time to respond.
Posted Jan 31, 2019 19:52 UTC (Thu)
by jani (subscriber, #74547)
[Link] (6 responses)
On the contrary, I think it's far better for people who are outsiders in the argument at hand but established members of the community to speak up. The graphics community and dri-devel are fairly civil, and I'd pretty much expect someone to speak up and not let it slide.
Indeed, per the freedesktop.org CoC, maintainers are on the hook for enforcing, which is the main difference to the kernel CoC. See c1d1ba844f01 ("Code of conduct: Fix wording around maintainers enforcing the code of conduct").
Posted Feb 1, 2019 4:05 UTC (Fri)
by nilsmeyer (guest, #122604)
[Link] (5 responses)
I have to respectfully disagree there. It may be a cultural thing, but I find it extremely rude to take offense on someone else's behalf. It suggests that person or group can't speak up for themselves and robs them of agency. I don't know if Christian asked Daniel to defend him.
Posted Feb 1, 2019 14:46 UTC (Fri)
by jani (subscriber, #74547)
[Link]
I can sympathize with that view. However, my point is, it's not just about anyone taking offense or speaking up to defend themselves to begin with. It's also about making clear to *everyone* what's not okay, regardless of what the people involved think. I think it's a much stronger message to and about the community. It's also why I prefer public replies asking people to behave themselves. The mailing list archives will record the standard we've walked past.
Posted Feb 2, 2019 13:19 UTC (Sat)
by emorrp1 (guest, #99512)
[Link] (3 responses)
Indeed, I'm hoping one of mid-term societal outcomes of this kind of conflict is an increase in personal resilience (shrug it off as another commenter put it). However, I also saved this link to remind myself of why someone may be hesitant to stand up for themselves: https://lists.debian.org/debian-devel/2018/07/msg00364.html
Posted Feb 4, 2019 10:12 UTC (Mon)
by nilsmeyer (guest, #122604)
[Link] (2 responses)
Posted Feb 4, 2019 22:47 UTC (Mon)
by emorrp1 (guest, #99512)
[Link] (1 responses)
Posted Feb 7, 2019 8:14 UTC (Thu)
by nilsmeyer (guest, #122604)
[Link]
Posted Jan 30, 2019 23:31 UTC (Wed)
by nilsmeyer (guest, #122604)
[Link] (2 responses)
and how do you resolve this conflict? Let's say someone objects to the term "master" (like master branch) on the grounds of being offended by it.
Posted Jan 30, 2019 23:52 UTC (Wed)
by mjg59 (subscriber, #23239)
[Link] (1 responses)
You have a reasonable conversation, attempt to understand the perspective of the other point of view, make a decision and then follow through on it. You're not necessarily going to find a solution that makes everyone happy, but that's not a reason not to try.
Posted Jan 31, 2019 3:47 UTC (Thu)
by nilsmeyer (guest, #122604)
[Link]
reasonable is another very ambiguous term. Also, when my goal is to develop good software, how is that helped by having debates like that?
Posted Feb 1, 2019 4:10 UTC (Fri)
by nilsmeyer (guest, #122604)
[Link] (12 responses)
To what extent are you required to participate in my delusion?
Posted Feb 1, 2019 5:28 UTC (Fri)
by mjg59 (subscriber, #23239)
[Link] (11 responses)
Posted Feb 1, 2019 6:36 UTC (Fri)
by nilsmeyer (guest, #122604)
[Link] (4 responses)
Posted Feb 1, 2019 7:55 UTC (Fri)
by mjg59 (subscriber, #23239)
[Link] (3 responses)
Posted Feb 1, 2019 12:34 UTC (Fri)
by nilsmeyer (guest, #122604)
[Link] (2 responses)
The binary spectrum is somewhat of a crutch but it works for the majority of people. Of course there are more sexes than male / female but as an approximation this can work. Just pick one, or none.
I don't have a problem when someone wants to be addressed with different male / female pronouns, and I can tolerate they / them, but don't call me an asshole when I don't get it right the first time. It's a matter of politeness I believe. I draw the line at Ze/Hir or some other recently made up pronouns. Trying to stay abreast of all the identities and pronouns that people came up with is almost a full time job, and basically it's asking me to agree fully with a political opinion or a philosophy (gender as a social construct). That's quite an imposition. There are even cases where someone tried to remove / discipline a developer on CoC grounds for voicing their opinion in other channels.
You can't be welcoming to everyone, very often to me it seems that CoC are designed to exclude the conservative and perhaps people on the autism spectrum. I think of course you are allowed to do that if you want to. If that's the goal, I would like it to be stated in the open instead of clouded in language of inclusiveness. Many times though it seems these things are backdoored into projects.
Apparently there are even people who identify as a different species, a fictional species or an object. It's impossible to tell if I'm being trolled. Very often this seems more like a lifestyle choice, to make yourself look more interesting, which I believe belittles the struggle of people with actual gender identity problems. Of course whether someone identifies as an Apache Helicopter doesn't really factor in to communication.
I had a classmate who later had gender reassignment surgery. What impressed me very much about her was the fortitude she displayed when dealing with abuse from others, which was sadly extremely frequent in that part of town (many conservative Muslims).
As a matter of practicality, does this extreme inclusiveness actually cause an influx of talent?
Posted Feb 1, 2019 13:21 UTC (Fri)
by james (subscriber, #1325)
[Link] (1 responses)
There is a certain amount of help that tooling can bring: I used to configure mutt to display emails from certain senders in a different colour, with one key to add someone to the list.
I used it to identify people who had their own viewpoints which were best respected from a distance, shall we say, but it would be easy to set up another list of people who needed extra care.
Posted Feb 2, 2019 20:15 UTC (Sat)
by nilsmeyer (guest, #122604)
[Link]
Your technological solutions is an interesting idea.
Posted Feb 1, 2019 11:19 UTC (Fri)
by lkundrak (subscriber, #43452)
[Link] (5 responses)
More seriously though, can the question of anyone's internal honesty on these matters be reliably answered? Does it even matter at all?
I man, if there's no cost associated with following whichever rules the other party finds respectful, why not just follow them? I guess we'll all be better off that way, including people that are distressed by being addressed with a different pronoun than they prefer, those who don't care, as well as Their Majesty.
Posted Feb 2, 2019 13:35 UTC (Sat)
by emorrp1 (guest, #99512)
[Link] (3 responses)
It used to be "professional" in documentation, journalism style guides etc. to refer to a person of unknown (but binary) gender as "he". I consider it right that this is hopefully now replaced with a more neutral "they", especially with an anonymous internet - but even making that habitual change is difficult for many.
So I'd say expecting others to use even more specific, unfamiliar pronouns, on a per-individual basis is going too far. Probably best experienced by interacting with kids just learning to talk "look, man with beard" is not easily replaced with "look, person with beard" - assuming the interesting thing about them from kids' point of view was an unfamiliar beard.
Posted Feb 2, 2019 16:58 UTC (Sat)
by jani (subscriber, #74547)
[Link]
Getting the gender pronouns and grammatical gender right in foreign languages can be incredibly hard. It's a fairly common mistake for Finns to get them wrong. I can relate to the difficulty of learning new pronouns. From experience, I think gender neutral pronouns are superior.
Posted Feb 4, 2019 3:30 UTC (Mon)
by flussence (guest, #85566)
[Link] (1 responses)
Posted Feb 4, 2019 15:59 UTC (Mon)
by nilsmeyer (guest, #122604)
[Link]
Alice and Bob (and so forth) are often used as examples in documentation.
Posted Feb 2, 2019 20:10 UTC (Sat)
by nilsmeyer (guest, #122604)
[Link]
There is a cost associated I believe. First of all you now have to remember how to refer to a certain person, there’s a need to educate new people so as not to upset anyone and inevitably not everyone will accept it, causing further conflict. It’s a question of whether you want to include people who make communication extremely difficult and what their potential contributions are.
Posted Jan 30, 2019 15:50 UTC (Wed)
by nix (subscriber, #2304)
[Link] (3 responses)
I operate by the rule of simply trying to treat people decently: I'm not going to try to waste time figuring out what level of legal paranoia the sort of people who use the word 'unprofessional' happen to mean this week.
Posted Jan 30, 2019 19:43 UTC (Wed)
by mathstuf (subscriber, #69389)
[Link] (1 responses)
Yeah…I'd have personally started looking elsewhere for employment. I don't see that being any different of a situation than having irreconcilable differences in a personal relationship and cutting it off. Granted, alternative employment opportunities generally being more necessary than having an SO of some kind may make it hard to have a gap.
> the other boss wanted me to never discuss bugs at all unless they were already fixed
Other companies go even farther and don't discuss unless a fix has been released. Again, not somewhere I'd want to work. Luckily, I get to work on FOSS even at my employer where the issue tracker is public.
> I operate by the rule of simply trying to treat people decently: I'm not going to try to waste time figuring out what level of legal paranoia the sort of people who use the word 'unprofessional' happen to mean this week.
I agree with this. However, when informed of some behavior stepping over a line, it is best to take that into account for future interactions.
Posted Jan 30, 2019 21:37 UTC (Wed)
by nix (subscriber, #2304)
[Link]
I did! Eventually. I had this feeling that doing free software hacking for pay would take all the fun out of it, y'see... (in a twist unsurprising to anyone here, it didn't. Having really clued co-workers is a big part of that.)
Posted Jan 31, 2019 20:07 UTC (Thu)
by epa (subscriber, #39769)
[Link]
Changing the world with better documentation
Changing the world with better documentation
Here's a recent example of an allegation of a violation of no less than two different codes of conduct: Re: [PATCH] lib/scatterlist: Provide a DMA page iterator.
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
- I'm not familiar with the people in the linked thread personally (though I've seen those names and handles on here on occasion);
- I don't know of other behavior that might be related, so I'm looking at this thread in isolation (e.g., does hch have a habit of such reactions or is Daniel Stone trigger happy on invoking the CoC); and
- I'm not familiar with the code in the discussion, so I can't tell if anyone is being purposefully difficult or ignorant as to technical points being made.
Changing the world with better documentation
Changing the world with better documentation
> drivers work you should not be lazy.
(It is also correct - the attitude which Christoph is responding to isn't the sort of attitude we try to encourage in the kernel)
The crudity and insult are certainly unnecessary and best avoided. The bluntness isn't particularly helpful, but that isn't actually a crime.
I would suggest something like:
The driver (according to Christoph) should be written to work on architectures which don't support coherent dma mapping in general - it shouldn't fail to load if the require mapping semantics aren't available.
- be emphatically polite - show that it can be done, and show how.
- be specific. Make sure you understand what is said, focus on the specific problem, explain how that comes across poorly, and point the the specific section of any CoC that you feel has been violated (if you want to bring the CoC up at all).
Changing the world with better documentation
Changing the world with better documentation
> I think it's also poor form to step in on someone else's behalf without
> giving Christian time to respond.
Changing the world with better documentation
Changing the world with better documentation
> rude to take offense on someone else's behalf. It suggests that person or group can't
> speak up for themselves and robs them of agency.
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
If this is causing someone severe distress that's a sign of a deeper issue (trauma for example).
Possibly. I'd hope most people would want to respect that distress, and not expect sufferers to shun human contact until the underlying issues were addressed.
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation
Changing the world with better documentation