Edward, Look forward to the results of what is a very ambitious timeframe. There are many Leo users who will be able to contribute greatly to the design, production and review of this new set of documentation.
As I was about to post these thoughts I noticed Reinhard's comments which I fully endorse. You noted in a recent post about you your plans for 2017: *"ScheduleI typically use an "expansion factor" of 4. If something seems like it might take a week, it may take up to a month."* I'll be happy to provide feedback, review and test but first I would suggest preparing a good specification and goals document. See draft above :) and Reinhard's further comments. It may help if the specification was available on Leo's github docs during the review process so reviewers can test against the goals. This impending Leo release gives the impression of being bigger and bolder than previous releases. Leo's *documentation will be a major part* of this release and I think we will all be stunned as to how good the user docs can be, and how they can propel Leo's adoption. Regards Lewis On Tuesday, February 14, 2017 at 11:36:04 PM UTC+11, rengel wrote: > > Let me give it a try. The following describes how I would approach the > documentation task. > [snip] > > That's about it. It's all too easy to mix *one's own goals* (creating the > doumentation) with the *instructional goals* of the documentation. > *Instructional > goals* describe what a member of the target audience should be able to do > after reading the documentation, not what one wants to accomplish (*your > *goal > above). > > Why three target audiences? > > - Not every computer wants to programm. But almost every computer user > can benefit from an outliner. > - Not every programmer wants to program their IDE or to learn Python. > But every programmer can benefit from a powerful organizing tool for > projects and programs > > Of course, any of the above stated goals and strategies should be > elaborated. These are just my first thoughts on the documentation task. > > > Greetings! > > > Reinhard > -- 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 https://groups.google.com/group/leo-editor. For more options, visit https://groups.google.com/d/optout.
