News for hackers. Stuff that matters.
Re:Remote Only by kharak on Thursday June 07, 2018 @09:51AM (#17255719)
I'm mildly confused. Your post here seems fine and quit readable. How do you arrive at the conclusion, that you're lacking in written communication skills?

(sorry for question instead of tips)

Re:Remote Only by scarecrowbob on Thursday June 07, 2018 @10:23AM (#17255968)
In a sense, your confusion here -is- the problem:

"conveying complex subject matter in a succinct way for folks lacking detailed domain knowledge."

FWIW, I didn't have the same confusion about the post, so I don't know how lacking the author is in this specific setting.

But I have had the same general struggle.

I have an MA in English/rhetoric and am a software dev, and even with that nexus of training it has been a lot of work to get better at communicating... the struggle to communicate technical issues to non technical people is a lifelong journey with a complex path. It's just hard.

So here's my tip:

smaller sentences. More paragraphs. Simpler language.

And IME we do best when we develop a continual awareness that although communication is difficult, it is possible.

Re:Remote Only by aeorgnoieang on Thursday June 07, 2018 @01:15PM (#17257913)
> So here's my tip: > > smaller sentences. More paragraphs. Simpler language.

I've also found thinking about sensual clues to be helpful, e.g. what would the user/customer/whatever see (or hear or feel) at this point? What (exact) text would they reasonably anchor on based on everything they might see? I also try to visually distinguish different types of info, e.g. exact text of some kind of UI element, code.

Another really helpful tip is to confirm that the user/customer/whatever sees/hears/feels some (exact) specific thing at a specific { step / point in space-time }. If they don't provide the (near) exact response I expect, I try to notice my confusion and debug right then and there until my confusion is resolved.

Re:Remote Only by scarecrowbob on Thursday June 07, 2018 @02:07PM (#17258497)
This is useful advice.

If you abstract it, the general form is something like "work with concepts that your audience is already familiar with", which is good advice for any communication. And, similarly, be on the look out for any data that says your communication has started to go awry.

Re:Remote Only by Fnoord on Thursday June 07, 2018 @10:39AM (#17256109)
Sample size is one, and they might've discussed this before. Someone with good written communication skills can write effectively, without too much details, quickly on the fly. The same holds true for verbal.

I believe there's two important key points: confidence (but not overconfidence) and empathy/sympathy. Putting yourself in the other person's shoe and figuring what they need to hear ie. not what you want to express. The latter is secondary!

Sure, you can practice it, but only so much. I have autism, and I'm utter shit at this (even in my native language). I've been practicing it pretty much all my life (I remember having issues with it at elementary school). I'm terrible with being to the point and keeping communication short. And if it is short, its usually too rude.

Re:Remote Only by dagurp on Thursday June 07, 2018 @10:10AM (#17255844)
Maybe it took a long time to write that post. That's what I struggle with anyway.
Re:Remote Only by specialist on Thursday June 07, 2018 @10:22AM (#17255949)
"I would have written a shorter letter, but I did not have the time." -- Blaise Pascal

I encourage you to not criticize yourself too harshly.

Re:Remote Only by pricees on Thursday June 07, 2018 @10:20AM (#17255927)
I reread it a few times. I reread it aloud. This is a new discipline.
Re:Remote Only by NoNotTheDuo on Thursday June 07, 2018 @09:54AM (#17255747)
May be evidence that the additional training/work s/he's put in is paying off. I agree that the post does not show a lack of written communication skills.