From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.comp.tex.context/88099 Path: news.gmane.org!not-for-mail From: Hans Hagen Newsgroups: gmane.comp.tex.context Subject: Re: State of documentation of ConTeXt? Date: Mon, 14 Jul 2014 19:29:22 +0200 Message-ID: <53C41372.7080802@wxs.nl> References: <1642f57885676cbd1020027a2bff7c40.squirrel@webmail.xs4all.nl> Reply-To: mailing list for ConTeXt users NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="windows-1252"; Format="flowed" Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1405358999 14630 80.91.229.3 (14 Jul 2014 17:29:59 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 14 Jul 2014 17:29:59 +0000 (UTC) To: mailing list for ConTeXt users Original-X-From: ntg-context-bounces@ntg.nl Mon Jul 14 19:29:54 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 1X6k4W-0007NP-LX for gctc-ntg-context-518@m.gmane.org; Mon, 14 Jul 2014 19:29:52 +0200 Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id E62D41025D for ; Mon, 14 Jul 2014 19:29:51 +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 hgPQTWMxFPp3 for ; Mon, 14 Jul 2014 19:29:51 +0200 (CEST) Original-Received: from balder.ntg.nl (localhost [IPv6:::1]) by balder.ntg.nl (Postfix) with ESMTP id 1A8BB1025F for ; Mon, 14 Jul 2014 19:29:44 +0200 (CEST) Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id 20DD3101F6 for ; Mon, 14 Jul 2014 19:29:40 +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 M+bOLbvod3MA for ; Mon, 14 Jul 2014 19:29:34 +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 811E9101EB for ; Mon, 14 Jul 2014 19:29:29 +0200 (CEST) Original-Received: from smtp.ziggozakelijk.nl (D57D1DA2.static.ziggozakelijk.nl [213.125.29.162]) by filter1-ams.mf.surf.net (8.14.3/8.14.3/Debian-9.4) with ESMTP id s6EHTSts026363 for ; Mon, 14 Jul 2014 19:29:28 +0200 X-Default-Received-SPF: pass (skip=loggedin (res=PASS)) x-ip-name=10.100.1.103; Original-Received: from [10.100.1.103] (unverified [10.100.1.103]) by pragma-net.nl (SurgeMail 6.5a2) with ESMTP id 10881-1713362 for ; Mon, 14 Jul 2014 19:29:27 +0200 User-Agent: Mozilla/5.0 (Windows NT 6.3; WOW64; rv:24.0) Gecko/20100101 Thunderbird/24.6.0 In-Reply-To: <1642f57885676cbd1020027a2bff7c40.squirrel@webmail.xs4all.nl> X-Authenticated-User: hagen@controller-9 X-Bayes-Prob: 0.0001 (Score 0, tokens from: ntg-context@ntg.nl, base:default, @@RPTN) X-CanIt-Geo: ip=213.125.29.162; country=NL; region=Provincie Overijssel; city=Zwolle; latitude=52.5058; longitude=6.0858; http://maps.google.com/maps?q=52.5058,6.0858&z=6 X-CanItPRO-Stream: uu:ntg-context@ntg.nl (inherits from uu:default, base:default) X-Canit-Stats-ID: 0NMqhts4b - a037530bf7d0 - 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:88099 Archived-At: On 7/14/2014 3:03 PM, Rob Heusdens wrote: > 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? quite some sub-systems are described in their own manuals (fonts, = tables, xml, ...) and these manuals are quite up to date (and easier to = maintain than one big fat manual also, additional documentation is something that users need to = participate in (just pick a topic) even if it has high priority, that doesn't mean that those involved have = much free time left to do that next to their regular work (as usual most = development is done in spare time) so, patience is needed, Hans >> 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 d= id >> 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= the Wiki! > > maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-co= ntext > webpage : http://www.pragma-ade.nl / http://tex.aanhet.net > archive : http://foundry.supelec.fr/projects/contextrev/ > wiki : http://contextgarden.net > _________________________________________________________________________= __________ > -- = ----------------------------------------------------------------- Hans Hagen | PRAGMA ADE Ridderstraat 27 | 8061 GH Hasselt | The Netherlands tel: 038 477 53 69 | voip: 087 875 68 74 | www.pragma-ade.com | www.pragma-pod.nl ----------------------------------------------------------------- ___________________________________________________________________________= ________ 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 ___________________________________________________________________________= ________