Hi All,
Maybe, we could setup a collaborative work group to do the documentation.
That is a group of us are responsible for certain groups of commands. This way
the manuals can become more complete. That way some of the more advance
stuff that is hardly documented finally gets documented.
What we would need is a specification for:
1) how the command and its parameters are portrayed
2) full description of defaults values and their effects and side effects
3) general intention of the command its parameters
4) MWEs describing the standard use of all parameters
5) MWEs for non standard use (Advanced technics)
6) standrad way for referencing other commands
If everybody follows the conventions we can then combine all the parts to a
comprehensive manuals. They will work as a reference and tutorial.
When something new is introduced the group is informed and can update their
subject(s).
I would be willing to help. Any other takers?
regards
Keith.
Am 21.03.2013 um 15:26 schrieb Marcin Borkowski
Dnia 2013-03-21, o godz. 11:32:01 Alan BRASLAU
napisaĆ(a): On Thu, 21 Mar 2013 11:19:24 +0100 Mojca Miklavec
wrote: Marcin wasn't talking about organizing the wiki page, but about writing up-to-date and complete manuals (in PDF) which is nearly impossible with the speed that Hans keeps developing ConTeXt ;).
Unless we find funding somewhere to assign someone sufficiently competent to work full-time for Hans just to write and maintain documentation.
This is not a bad idea if only we could get it sponsored...
I have an impression that I heard about something similar to GSoC, but for writing docs...
Also, it might not need a full-time job, even if you want to keep up with Hans' speed. And even a good free book on, say, a "snapshot" of ConTeXt from some point in time (later than official manuals) would be useful.