That's a great article and highlights something I preach/teach all the time; know your audience. I also think there's a third, and significantly larger audience of 'users'. Perhaps most of them aren't interested in the code base itself, but simply in how Leo works. I count myself as part of that audience, despite sometimes wanting to be part of audience #2; just don't have the programming 'chops' to get there quickly and easily.
Rob... On Monday, August 6, 2018 at 11:06:11 AM UTC-4, Edward K. Ream wrote: > > This page <https://www.math.hmc.edu/~su/math131/good-math-writing.pdf> > contains guidelines for good mathematical writing. Imo, it generalizes > pretty well to any kind of technical writing. > > The first principle, "Know your audience" applies to our recent > discussions of code refactoring and simplification. There are at least two > "audiences" for Leo's own code. The first audience is Leo's devs. The > second, even more important audience is "scripting users", that is, writers > of scripts/plugins. We always want to minimize the effects of "cleanups" > on scripting users. > > 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 leo-editor+unsubscr...@googlegroups.com. To post to this group, send email to leo-editor@googlegroups.com. Visit this group at https://groups.google.com/group/leo-editor. For more options, visit https://groups.google.com/d/optout.