On Saturday, 2 November 2013 16:11:00 UTC+1, Chris George wrote: > > Not to be too picky, but I found this confusing. Is there a prior tutorial > that covers some of this (things like @settings trees within documents) > that should be completed before the rst3 tutorial? What is the required > knowledge level of your target audience for this tutorial? > > Are you assuming a person with little or no knowledge about Leo going > through this tutorial or are there prerequisites? If there are > prerequisites, would it not make sense to detail them at the beginning? > Something like "Someone going through this tutorial should have a basic > idea about (concept x) and have completed (tutorial Q). What is blindingly > obvious to you may not be so obvious to someone else. If the rst3 tutorial > is part of a hierarchy of concepts, where does it fit? Another > example: Does the rst3_call_docutils setting go in the node or the body? If > I have zero experience with the @settings tree in a .leo document (only > having met the idea in relation to the two settings files), this becomes a > question in my mind. >
I could hardly resist the temptation to chime in on this cue. I hope that no one minds hwat I am going to say, but I experienced exactly the same problem (with the general Leo documentation). Granted, you guys are doing a terrific job with the documentation, but there are still some blind spots to cover. What I mean is that, from my experience, the documentation is not basic enough for the total newbie. I started reading the documentation a couple of months ago, with great enthusiasm, but dropped out after a short while, simply because I was not able to understand the concepts being cross-referred to. I felt as if the documentation somehow assumed that the reader has some prior knowledge, which I did not have. Now that in the the last couple of months there has been a flurry of activity (especially on Edward's part) for improving the documentation, for which we are thankful (I, for one), I think I will try again. Please, make sure that every new concept introduced is properly explained. -- 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.
