KBD

Keith Devens .com

Sunday, October 12, 2008 Flag waving
Follow the path. – me
← FastTCPfoo, bar, baz... ? →

Daily link icon Saturday, June 7, 2003

Explaining things to others

Tim Bray shows us the philosophy we should all have when explaining things to others:

... when I explain something to someone and they don't get it, that's my problem, not theirs.

Then he asks for discussion about how to explain his topic effectively, but he doesn't allow comments on his web siteSmiley sticking out its tongue

His point is well-taken. The way you explain something is entirely dependent upon your audience, and is contingent upon their background and experience. If you're not explaining things in a way your audience can understand, that's your fault, not theirs.

Explaining things in a way your audience can understand often involves leaving out information. Going into too much detail is often a problem people (including myself) have. Programmers and other technical people in particular like to show off what they know, and revel in the little details of how everything they're explaining fits together. Piece of advice: It's great that you know what you're talking about, but when explaining it, think about your audience, not yourself.

Sometimes, however, it's simply not clear what your audience will be able to handle. How far back do you have to go to make something clear to someone when what you're explaining depends on so many other things your audience isn't familiar with? That is often the hardest part of explaining, not getting the details right.

One problem I often have is that I don't want to lie to someone or be misleading, so I often feel the need to go qualify many things as I go along. The problem is that the person probably doesn't know the difference or even care, and would be better served if I did "lie" to hide unimportant details. That's a hurdle I have trouble getting over.

← FastTCPfoo, bar, baz... ? →

Comments XML gif

sparticus (http://www.iamsparticus.co.uk) wrote:

Surely it's sometimes their problem. I mean, someone could explain something incredibly well, but the other person might not get it. They could simply not want to understand.

But I know what you mean about not wanting to lie to simplfy things so they make sense. I think the solution lies in having to spend time with children. Then you end up lie/simplfying all the time. I know I do. Like calvins dad out of calvin and hobbes, only less so. "How does a light bulb work?" "magic" "didn't you say thats how the vacuum cleaner works?" "right. they're both magic"

∴ sparticus | 7-Jun-2003 3:45pm est | http://www.iamsparticus.co.uk | #2156

ideoplastos (http://www.ideoplastos.net) wrote:

Huh?

∴ ideoplastos | 10-Jun-2003 11:03pm est | http://www.ideoplastos.net | #2170

Keith (http://www.keithdevens.com/) wrote:

Huh what?

Keith | 10-Jun-2003 11:15pm est | http://www.keithdevens.com/ | #2171

Feel free to post a comment below. Please see my comment policy.

Formatting Rules (No HTML):

  • **bold**, *italic*, _underlined_, --strikeout--
  • "text"="url" creates a link, and URLs are auto-highlighted
  • Blockquote: Like e-mail, begin paragraph with > (greater-than sign)
  • Lists: begin paragraph with *,-, or + (unordered), or # (ordered)
  • Code block: ?!code:language=perl|php|sql|javascript|etc.{\n}...{\n}?!/code

:
(will be your IP address if blank)
: (optional)
(Will not be shown on site)

: (optional)
:

October 2008
SunMonTueWedThuFriSat
 1234
567891011
12131415161718
19202122232425
262728293031 



RSS feed RSS feed for Keith's Weblog
Atom feed Atom feed for Keith's Weblog
Weblog archive
Recent comments
  on 8 posts

Recent comments XML

new⇒URL design

http://groups.google.com/group/cool​ndex/web/asian-girl-sucking-to-blac​k-man...

derek: Oct 12, 12:13pm

I hate PHP

Elliot Anderson,

Dude!! You the​man! The reverse replacement for​array_u...

Alex Ndungu: Oct 11, 1:35am

Call a function from a string in Python

?!code:
some_object.__getattribute​__('method_name')()
?!/code

is​the s...

Patrick Corcoran: Oct 8, 3:53pm

Spider solitaire

I have won 185 games of Spider​Solitaire at the "Difficult" level.​ What is...

75.179.28.113: Oct 8, 12:42pm

Sed one-liners

Hi.

I wanted to let you know​that I wrote an article "Famous Sed​One-Lin...

Peteris Krumins: Oct 8, 3:05am

Timesheet Calculator

Hadn't seen it before now, but my​company already uses a time​tracking prog...

Keith: Oct 7, 10:44am

Girls, please don't get breast implants

Hey everyone, 

I am new to this​blog and I have enjoyed reading all​your...

Sarah.M.: Oct 6, 9:45am

Generated in about 0.233s.

(Used 8 db queries)

mobile phone