On Sunday, October 13, 2013 5:24:34 PM UTC-2:30, Edward K. Ream wrote: > > On Sun, Oct 13, 2013 at 10:17 AM, Edward K. Ream > <[email protected]<javascript:> > > 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 > May I demur? I read the example and its explanation with care, and for the first time I had a sense of what scripting is about: doing things with generators, positions and vnodes -- each of which is then briefly explained. So for me at least it was the perfect level of introduction. The only thing I would change: "The execute-script command (for example from the Edit menu or type ctrl-B) ...." Agreed: just-in-time delivery of ideas is a skill, and one well worth acquiring. geoff
-- 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.
