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.
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
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)
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.
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.
regards
Keith.
Am 19.03.2013 um 19:16 schrieb Hans Hagen
Hi,
[snip, snip]
Then there are the documents:
- Update the xml descriptions (Wolfgang has been working on this, and there is the wiki).
- Finish the 'cld' manual (mostly done).
- Update the 'xml' mkiv manual (doable, maybe users have examples too).
- Finish the updated 'mathml' manual (done but needs checking but then I might overhaul the whole lot again).
- Finish the more technical 'mkiv font' manual (tedious job but okay).
- Pickup the 'stylistics' manual (also nice to do but a bit tedious).
- Turn 'hybrid' into a more finished document (the second part of the history of mkiv/luatex).
- Add more to the 'about' series (the third part).
Of course this is too ambitious but it's good to remind myself that some work needs to be done. And ... users might have ideas of what needs to be done as well.
Hans