On Sun, Oct 13, 2013 at 10:17 AM, Edward K. Ream <[email protected]>wrote:

> Below is the first draft of an "introductory example", supposedly to start
> off the scripting chapter.
>
> This is *way* too much data!  Newbies will run away screaming. Somehow, it
> must be greatly simplified.
>

It seems that the twin challenges of technical writing are:

- Knowing what *not* to say, or at least when not to say it.
- Knowing the order of what *to* say.


These seem more difficult, and thus more interesting(!), than many
programming puzzles.

EKR

-- 
You received this message because you are subscribed to the Google Groups 
"leo-editor" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/leo-editor.
For more options, visit https://groups.google.com/groups/opt_out.

Reply via email to