On 3/20/2013 9:12 AM, Keith J. Schultz wrote:
Hi Hans, All,
The biggest crux in using ConTeXt is its documentation. True, things have gotten a lot better in the past year!
Yet, there is no ONE definitive place to get comprehensive and EASY to find documentation.
1) Garden is really not that easy to navigate 2) Garden is loaded with a mixture of mkii and mkiv and it is not always clear if the page one is on is for mkii or mkiv or quite outdated.
i wonder how easy it is to split that ... we could move mkii stuff to s separate place (or always at the bottom below a "MKII" subtitle)
3) PRAGMA does have up to date manuals. 4) These manuals are quite unfinished in many parts, as are all many of the older manuals.
Very frustrating
Most of the old manuals are not that faulty. Maybe incomplete with respect to the latest features, but most in it should still work. With respect to unfinished: yesterday i wondered if I should put the intermediate but unfinished font manual on the website but it looks like I can better not do that.
5) The newer manuals should be part of the standalone. ( I hate going online to look for a manual when it should be installed already)
Up to others.
6) Reference manuals are fine for the advanced user, but for the beginner or intermediate they are not much help. Especially, if if one does not understand TeX, or Typesetting, and one really does not need to use all those options.
That's up to users ... it has been said before, but this is where the internet backfires: a lot of tex tutorials started out as articles i.e. users writing down experiences. I simply have no more time left to write down more than I do now.
My suggestion would be to have garden have a manuals download area where one can get the up to date manuals from Pragma and where one can discern how old the others are. It should be also, easy to find.
So maybe you can help Mojca with that .. someone needs to do it and keep doing it (descriptions, copies cq. links, etc.). Hans ----------------------------------------------------------------- Hans Hagen | PRAGMA ADE Ridderstraat 27 | 8061 GH Hasselt | The Netherlands tel: 038 477 53 69 | voip: 087 875 68 74 | www.pragma-ade.com | www.pragma-pod.nl -----------------------------------------------------------------