Re: upto current

["Keith J. Schultz" <keithjschultz@web.de>]

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 <pragma@wxs.nl>:

> 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

___________________________________________________________________________________
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
___________________________________________________________________________________