> No, not like those.  I mean like a real manual.  I read the book
> about Hasselt---a few examples without explanations.

I am absolutely gobsmacked (astounded, astonished) at some of the comments on this and other threads!
"ConTeXt - an Excursion" and "ConTeXt the Manual" together are wonderful. I still consult them at least once a week
after 4 year's use. If you actually tried the examples in the former, rather than just reading them, you
would be an expert user within 2 days!

It would be nice to think that the community could construct documentation, but good, coherent documentation
is much harder to produce than good code! It works for collections of small articles (WikiPedia etc), but
I've never seen a good book written by a community.

While it would be nice to have an updated "ConTeXt the Manual", in my humble opinion the biggest hole
in the documentation is a reference for each command. Texshow-web should fill this gap and this is
where the community CAN contribute, and where the mechanism already exists. And because it's made up of
small articles it could work. When I learn about a command I try to fill in a few words in
texshow-web. If everyone added a few words each time they learn a new command, we would soon have
a fantastic reference source.

Richard

P.S. One request for improvement to texshow-web: the source-file for each command is included
in cont-en.xml, could this be displayed on the command web-page? It would make it easier to
find the source if you need to.





Converteam UK Ltd. Registration Number: 5571739 and Converteam Ltd. Registration Number: 2416188

Registered in England and Wales.

Registered office: Boughton Road, Rugby, Warwickshire, CV21 1BU.



CONFIDENTIALITY : This e-mail and any attachments are confidential and may be privileged. If you are not a named recipient, please notify the sender immediately and do not disclose the contents to another person, use it for any purpose or store or copy the information in any medium.



Please consider the environment before printing this e-mail