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
-----------------------------------------------------------------
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the
Wiki!
maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage : http://www.pragma-ade.nl / http://tex.aanhet.net
archive : http://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___________________________________________________________________________________
