From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.comp.tex.context/56847 Path: news.gmane.org!not-for-mail From: Alan BRASLAU Newsgroups: gmane.comp.tex.context Subject: Re: suggestions for context documentation Date: Mon, 8 Mar 2010 15:51:24 +0100 Organization: CEA DSM-IRAMIS-SPEC Message-ID: <201003081551.24238.alan.braslau@cea.fr> References: <4B94EE20.7070500@wxs.nl> Reply-To: mailing list for ConTeXt users NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1268059903 10205 80.91.229.12 (8 Mar 2010 14:51:43 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 8 Mar 2010 14:51:43 +0000 (UTC) Cc: Hans Hagen To: ntg-context@ntg.nl Original-X-From: ntg-context-bounces@ntg.nl Mon Mar 08 15:51:34 2010 Return-path: Envelope-to: gctc-ntg-context-518@m.gmane.org Original-Received: from balder.ntg.nl ([195.12.62.10]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1NoeIu-0006Fa-Jy for gctc-ntg-context-518@m.gmane.org; Mon, 08 Mar 2010 15:51:32 +0100 Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id EA3ACC9D32; Mon, 8 Mar 2010 15:51:31 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at balder.ntg.nl Original-Received: from balder.ntg.nl ([127.0.0.1]) by localhost (balder.ntg.nl [127.0.0.1]) (amavisd-new, port 10024) with LMTP id mYwm7C-5VLAa; Mon, 8 Mar 2010 15:51:29 +0100 (CET) Original-Received: from balder.ntg.nl (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id 52682C9E17; Mon, 8 Mar 2010 15:51:29 +0100 (CET) Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id F2877C9D32 for ; Mon, 8 Mar 2010 15:51:27 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at balder.ntg.nl Original-Received: from balder.ntg.nl ([127.0.0.1]) by localhost (balder.ntg.nl [127.0.0.1]) (amavisd-new, port 10024) with LMTP id CNdt-Vi4bmxD for ; Mon, 8 Mar 2010 15:51:25 +0100 (CET) Original-Received: from cirse-out.extra.cea.fr (cirse-out.extra.cea.fr [132.166.172.106]) by balder.ntg.nl (Postfix) with ESMTP id A8D48C9E17 for ; Mon, 8 Mar 2010 15:51:25 +0100 (CET) Original-Received: from epeire2.extra.cea.fr (epeire2.extra.cea.fr [132.167.198.32]) by cirse.extra.cea.fr (8.14.2/8.14.2/CEAnet-Internet-out-2.0) with ESMTP id o28EpP4B011076 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 8 Mar 2010 15:51:25 +0100 Original-Received: from orpin2.extra.cea.fr (orpin2.extra.cea.fr [132.167.198.5]) by epeire2.extra.cea.fr (8.14.2/8.14.2) with ESMTP id o28EpO3O021219; Mon, 8 Mar 2010 15:51:24 +0100 (envelope-from alan.braslau@cea.fr) Original-Received: from dogger.localnet (dogger.saclay.cea.fr [132.166.21.4]) by orpin2.extra.cea.fr (8.13.8/8.13.8/CEAnet-Intranet-out-1.1) with ESMTP id o28EpOsd014111; Mon, 8 Mar 2010 15:51:24 +0100 User-Agent: KMail/1.12.4 (Linux/2.6.32; KDE/4.3.4; i686; ; ) In-Reply-To: <4B94EE20.7070500@wxs.nl> X-BeenThere: ntg-context@ntg.nl X-Mailman-Version: 2.1.12 Precedence: list List-Id: mailing list for ConTeXt users List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: ntg-context-bounces@ntg.nl Errors-To: ntg-context-bounces@ntg.nl Xref: news.gmane.org gmane.comp.tex.context:56847 Archived-At: On Monday 08 March 2010 13:31:28 Hans Hagen wrote: > > As I was on the Dante 2010 meeting and as I could not access my > mail last week, today I ran into the long thread about > documentation. I will not reply to each mail but stick to this > summary. Now, I understand that there is a lack of documentation > but before one complains too loud about it, consider the > following: > I was out of town for the last two weeks. I too saw this thread but did not have the time to read it all. I agree that the ConTeXt reference manual needs to be updated and completed, in particular concerning mkIV. Nevertheless, I have been able to get quite far using the (old) mkII manual and find it to be pretty good, even if not perfect. For this reason, I had contacted Hans and Taco to gain access to the source but have to date made only a few, minor corrections. This is a project that I try to work on in my "spare time". As none of us have much time to spare from our other responsibilities, documentation always proceeds too slowly. (Indeed, while traveling the last two weeks, I had hoped to have some time available to work more on this. However, I did not do anything!) Part of the problem with writing documentation is being expert enough to know all of the in's and out's of ConTeXt. Nevertheless, I believe that improvements can be done. Also, taking such initiative will motivate the real experts to eventually complete the holes (or give hints on what further to include). Alan P.S. Concerning LaTeX, whereas the User's Guide and Reference Manual (what we locally call "the lion") and the Companion (1st edition, what we call "the dog") are excellent starting points. I find that the second edition to be confusing and so hardly ever refer to it. The documentation of the diverse packages is of diverse quality. ___________________________________________________________________________________ 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 ___________________________________________________________________________________