From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.comp.tex.context/88097 Path: news.gmane.org!not-for-mail From: "Rob Heusdens" Newsgroups: gmane.comp.tex.context Subject: Re: State of documentation of ConTeXt? Date: Mon, 14 Jul 2014 15:03:05 +0200 Message-ID: <1642f57885676cbd1020027a2bff7c40.squirrel@webmail.xs4all.nl> References: Reply-To: mailing list for ConTeXt users NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1405343022 7077 80.91.229.3 (14 Jul 2014 13:03:42 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 14 Jul 2014 13:03:42 +0000 (UTC) To: "mailing list for ConTeXt users" Original-X-From: ntg-context-bounces@ntg.nl Mon Jul 14 15:03:37 2014 Return-path: Envelope-to: gctc-ntg-context-518@m.gmane.org Original-Received: from balder.ntg.nl ([5.39.185.229]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1X6fur-0000Qs-59 for gctc-ntg-context-518@m.gmane.org; Mon, 14 Jul 2014 15:03:37 +0200 Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id 9ACE21025D for ; Mon, 14 Jul 2014 15:03:36 +0200 (CEST) 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 Tw5Rjx30+Xxa for ; Mon, 14 Jul 2014 15:03:36 +0200 (CEST) Original-Received: from balder.ntg.nl (localhost [IPv6:::1]) by balder.ntg.nl (Postfix) with ESMTP id EFCE71025E for ; Mon, 14 Jul 2014 15:03:28 +0200 (CEST) Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id A94D9101EB for ; Mon, 14 Jul 2014 15:03:25 +0200 (CEST) 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 7QHuV4nS4xtH for ; Mon, 14 Jul 2014 15:03:20 +0200 (CEST) Original-Received: from filter1-ams.mf.surf.net (filter1-ams.mf.surf.net [192.87.102.69]) by balder.ntg.nl (Postfix) with ESMTP id 387A2101E6 for ; Mon, 14 Jul 2014 15:03:15 +0200 (CEST) Original-Received: from smtp-vbr15.xs4all.nl (smtp-vbr15.xs4all.nl [194.109.24.35]) by filter1-ams.mf.surf.net (8.14.3/8.14.3/Debian-9.4) with ESMTP id s6ED351P021074 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT) for ; Mon, 14 Jul 2014 15:03:09 +0200 Original-Received: from webmail.xs4all.nl (dovemail17.xs4all.nl [194.109.26.19]) by smtp-vbr15.xs4all.nl (8.13.8/8.13.8) with ESMTP id s6ED35sH029503 for ; Mon, 14 Jul 2014 15:03:05 +0200 (CEST) (envelope-from robheus@xs4all.nl) Original-Received: from 82.95.176.15 (SquirrelMail authenticated user robheus) by webmail.xs4all.nl with HTTP; Mon, 14 Jul 2014 15:03:05 +0200 In-Reply-To: User-Agent: SquirrelMail/1.4.18 X-Virus-Scanned: by XS4ALL Virus Scanner X-Bayes-Prob: 0.0001 (Score 0, tokens from: ntg-context@ntg.nl, base:default, @@RPTN) X-CanIt-Geo: ip=194.109.24.35; country=NL; latitude=52.5000; longitude=5.7500; http://maps.google.com/maps?q=52.5000,5.7500&z=6 X-CanItPRO-Stream: uu:ntg-context@ntg.nl (inherits from uu:default, base:default) X-Canit-Stats-ID: 0NMqd353f - 379b4b876c4d - 20140714 (trained as not-spam) X-Scanned-By: CanIt (www . roaringpenguin . com) on 192.87.102.69 X-BeenThere: ntg-context@ntg.nl X-Mailman-Version: 2.1.14 Precedence: list List-Id: mailing list for ConTeXt users List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: ntg-context-bounces@ntg.nl Original-Sender: ntg-context-bounces@ntg.nl Xref: news.gmane.org gmane.comp.tex.context:88097 Archived-At: Hello G / all I started using ConText about a year ago. But as a "novice" to Context (and Tex in general) I can say is that this would be the first thing to work on, because currently it is a bit of a pain to start using ConText in any serious way, because there is a lack of up-to-date documentation. The mailing list here does make a good contribution to explaining things (I did not use it before, but while the Contextgarden was offline for a while last week, this was the only place for getting needed info) that the documentation and contextgarden wiki misses. But I think a regular user would want to have up-to-date documentation, and many examples worked out and a whole bunch of ready to use (well documented) templates/start documents for all kinds of use-cases. The contextgarden wiki often does not provide well enough information. There are commands with over 20 different parameters, and the most of them are not documented at all. So, a novice user can only use the commands in a trivial sense, but for advanced use the command provides, there is no documentation on how it is supposed to work. This is a pitty, because the ConText distribution really offers a lot of features one want for avanced typesetting jobs, but too often one wants to understand the behaviour of some command or use the advanced options which are provided, but can't because the documenation is too poor to make sense of it. To look in the source is not a a good replacement for that I guess (only for advanced users which co-develop ConText). Well at least the mailing list provides the answers one wants, but it would be far better I guess if such information would be up-to-date on contexgarden. Can we make this a feature request with HIGH priority? Greetings, Rob. > Hello guys, > > I am restarting a book project I started a several years back. At that > time I set up a copy of another project I am working on in ConTeXt, so > with the products/environment/chapters structure, added Mac fonts to my > setup, using texexec for compilation. > > Now that I am restarting, I am returning to ConTeXt. The first thing I did > was go to contextgarden and look for updated documentation. What I found > was the over 10-year old documentation (contextref.pdf) with green boxes > stating things like =93TODO: Add some text about recent developments, > especially the split between mkii and mkiv=94. > > Is there up-to-date and reasonably complete ConTeXt documentation these > days? > > G > _________________________________________________________________________= __________ > 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 > _________________________________________________________________________= __________ > ___________________________________________________________________________= ________ If your question is of interest to others as well, please add an entry to t= he Wiki! maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-cont= ext webpage : http://www.pragma-ade.nl / http://tex.aanhet.net archive : http://foundry.supelec.fr/projects/contextrev/ wiki : http://contextgarden.net ___________________________________________________________________________= ________