3 edited tags
| link
    Tweeted twitter.com/#!/StackWriters/status/215211116299694081
2 sample for HedgeMage
source | link

Most of what I write is non-fiction -- technical books, blog posts on open source topics, political stuff, etc. I Lately, I find lately that some of the topics I'mI am trying to present are much more technical than the intended audience is used to. I already plan to:

  • Explain terms the first time they are used.

  • Provide helpful asides (sidebars or footnotes, as appropriate) with explanations of concepts the reader might not already have.

    and

  • Use analogies to experiences already familiar to my readers whenever possible.

What else can I do to help a decidedly nontechnon-tech audience better understand a technical topic?

Most of what I write is non-fiction -- technical books, blog posts on open source topics, political stuff, etc. I find lately that some of the topics I'm trying to present are much more technical than the intended audience is used to. I already plan to:

  • Explain terms the first time they are used.

  • Provide helpful asides (sidebars or footnotes, as appropriate) with explanations of concepts the reader might not already have.

    and

  • Use analogies to experiences already familiar to my readers whenever possible.

What else can I do to help a decidedly nontech audience better understand a technical topic?

Most of what I write is non-fiction -- technical books, blog posts on open source topics, political stuff, etc. Lately, I find that some of the topics I am trying to present are much more technical than the intended audience is used to. I already plan to:

  • Explain terms the first time they are used.

  • Provide helpful asides (sidebars or footnotes, as appropriate) with explanations of concepts the reader might not already have.

    and

  • Use analogies to experiences already familiar to my readers whenever possible.

What else can I do to help a decidedly non-tech audience better understand a technical topic?

1
source | link

How can one make technical issues more accessible to a non-technical audience?

Most of what I write is non-fiction -- technical books, blog posts on open source topics, political stuff, etc. I find lately that some of the topics I'm trying to present are much more technical than the intended audience is used to. I already plan to:

  • Explain terms the first time they are used.

  • Provide helpful asides (sidebars or footnotes, as appropriate) with explanations of concepts the reader might not already have.

    and

  • Use analogies to experiences already familiar to my readers whenever possible.

What else can I do to help a decidedly nontech audience better understand a technical topic?