I've found the recommended reading from the essay speaks to me. 'The Science of Scientific Writing<http://www.americanscientist.org/issues/id.877,y.0,no.,content.true,page.1,css.print/issue.aspx>' gives practical before and after examples and clear theory (though I did have to print out hard copy and read slowly. It's densely packed and repays study.), while Jacob Kaplan-Moss’ Writing Great Documentation<http://jacobian.org/writing/great-documentation/>series provides inspiration and answers "why bother?".
On Sun, Sep 8, 2013 at 3:27 PM, Edward K. Ream <[email protected]> wrote: > On Wed, Sep 4, 2013 at 11:19 AM, Jacob Peck <[email protected]> wrote: > >> This link is making the rounds on slashdot and hacker news today: >> http://stevelosh.com/blog/**2013/09/teach-dont-tell/<http://stevelosh.com/blog/2013/09/teach-dont-tell/> >> > > I'd say it's an extremely chatty essay. The distinction between > documenting and teaching doesn't seem particularly well developed, but then > I only skimmed it... > > Edward > > -- > 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. > -- 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.
