Re: upto current

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

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 <mbork@wmi.amu.edu.pl>:

> Dnia 2013-03-21, o godz. 11:32:01
> Alan BRASLAU <alan.braslau@cea.fr> napisał(a):
> 
>> On Thu, 21 Mar 2013 11:19:24 +0100
>> Mojca Miklavec <mojca.miklavec.lists@gmail.com> 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.
> 

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