On 8-5-2010 10:43, Peter Münster wrote:
Here my questions:
- How could all these efforts be shared in the most efficient way?
- Are others already working for the above project?
- Is the structure of cont-en.xml already the good choice and it only needs some extensions for additional features, or would it be as good to use lua-tables (one lua-file per command for example)?
I think that it does not make much sense to extend cont-en.xml as extending it will make it way too big to be convenient. Also, I use that file for generating the current setup-* files as part of generating a beta an di'd like to keep that test. Of course adding more complete definitions (or fixing them) in cont-en.xml is welcome. I can add an index or whatever needed based on cont-en.xml as long sas it does not get bloated. So, how about more extensive info. As each command has a unique reference, the best approach is to have a separate file for each such entry. I suppose that this can be generated from the wiki. From that it's possible to generate something big (although big pdf's are not that much fun) or generate command specific files that are crosslinked to the main setup file.
I imagine the following steps: 1. decision how to structure the commands (lua or xml or ...)
the xml is handy for manipulations but documentation about tex can best be done in tex (verbatim can get quite messy in xml)
2. script for producing setup-en.pdf (perhaps Hans can provide his current converter?)
it's all in the distribution (x-set-*)
3. implementation of \showsetup (currently broken anyway)
hm, in what sense broken?
4. filling in the structure with all available information at the moment (last cont-en.xml, wiki) 5. putting nightly built setup-en.pdf on-line 6. filling the structure with all command descriptions
Then continuously: 7. updating command descriptions at each update on the wiki 8. updating command descriptions at each new context release 9. updating command descriptions whenever something seems not clear enough (questions on mailing list)
ambituous -) 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 -----------------------------------------------------------------