From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.comp.tex.context/81228 Path: news.gmane.org!not-for-mail From: "Keith J. Schultz" Newsgroups: gmane.comp.tex.context Subject: Re: upto current Date: Wed, 20 Mar 2013 09:12:21 +0100 Message-ID: <2F2ABC1E-124E-424D-94B4-E3CBF448E88A@web.de> References: <5148AB62.50002@wxs.nl> Reply-To: mailing list for ConTeXt users NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 (Mac OS X Mail 6.3 \(1503\)) Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1363767147 25234 80.91.229.3 (20 Mar 2013 08:12:27 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 20 Mar 2013 08:12:27 +0000 (UTC) To: mailing list for ConTeXt users Original-X-From: ntg-context-bounces@ntg.nl Wed Mar 20 09:12:53 2013 Return-path: Envelope-to: gctc-ntg-context-518@m.gmane.org Original-Received: from balder.ntg.nl ([195.12.62.10]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1UIE8i-0004C3-PD for gctc-ntg-context-518@m.gmane.org; Wed, 20 Mar 2013 09:12:52 +0100 Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id 84547101F7; Wed, 20 Mar 2013 09:12:29 +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 2DE5QtXm7dEE; Wed, 20 Mar 2013 09:12:26 +0100 (CET) Original-Received: from balder.ntg.nl (localhost [IPv6:::1]) by balder.ntg.nl (Postfix) with ESMTP id 677D5101EC; Wed, 20 Mar 2013 09:12:26 +0100 (CET) Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id 0A556101EC for ; Wed, 20 Mar 2013 09:12:25 +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 zuY5QO4GT7a2 for ; Wed, 20 Mar 2013 09:12:24 +0100 (CET) Original-Received: from filter3-ams.mf.surf.net (filter3-ams.mf.surf.net [192.87.102.71]) by balder.ntg.nl (Postfix) with ESMTP id E6E3F101EB for ; Wed, 20 Mar 2013 09:12:23 +0100 (CET) Original-Received: from mout.web.de (mout.web.de [212.227.15.3]) by filter3-ams.mf.surf.net (8.14.3/8.14.3/Debian-9.4) with ESMTP id r2K8CMj8030918 for ; Wed, 20 Mar 2013 09:12:23 +0100 Original-Received: from [10.0.62.4] ([84.58.242.156]) by smtp.web.de (mrweb002) with ESMTPSA (Nemesis) id 0LdEmn-1V03GB2Swr-00iDOG for ; Wed, 20 Mar 2013 09:12:22 +0100 In-Reply-To: <5148AB62.50002@wxs.nl> X-Mailer: Apple Mail (2.1503) X-Provags-ID: V02:K0:ddRmky9+Ya9qU4q3yOdGt9T2ZVDMocz9FPqzb6gVrFe U3saQ684P5IkRwilGMYaYqYuU4YYL5pS3VSlnnA1YCn8WXBbz1 WMDdbZIjngHZuHAON2ss6Gw9JC1EheLWeUUXNsLkxmAPEltXvT XmNofAfi+X///nglfzDu7mr0YTD4oexURrEBvV9Di26PeluMrR 0eiYOdDDyUgm79f9tckRQ== X-Bayes-Prob: 0.0001 (Score 0, tokens from: @@RPTN) X-CanIt-Geo: ip=212.227.15.3; country=DE; latitude=51.0000; longitude=9.0000; http://maps.google.com/maps?q=51.0000,9.0000&z=6 X-CanItPRO-Stream: uu:ntg-context@ntg.nl (inherits from uu:default, base:default) X-Canit-Stats-ID: 03JdIcngM - 8876a9321a55 - 20130320 (trained as not-spam) X-Scanned-By: CanIt (www . roaringpenguin . com) on 192.87.102.71 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:81228 Archived-At: Hi Hans, All, The biggest crux in using ConTeXt is its documentation. True, things have gotten a lot better in the past year! Yet, there is no ONE definitive place to get comprehensive and EASY to find documentation. 1) Garden is really not that easy to navigate 2) Garden is loaded with a mixture of mkii and mkiv and it is not always clear if the page one is on is for mkii or mkiv or quite outdated. 3) PRAGMA does have up to date manuals. 4) These manuals are quite unfinished in many parts, as are all many of the older manuals. Very frustrating 5) The newer manuals should be part of the standalone. ( I hate going online to look for a manual when it should be installed already) 6) Reference manuals are fine for the advanced user, but for the beginner or intermediate they are not much help. Especially, if if one does not understand TeX, or Typesetting, and one really does not need to use all those options. My suggestion would be to have garden have a manuals download area where one can get the up to date manuals from Pragma and where one can discern how old the others are. It should be also, easy to find. regards Keith. Am 19.03.2013 um 19:16 schrieb Hans Hagen : > Hi, > [snip, snip] > Then there are the documents: > > - Update the xml descriptions (Wolfgang has been working on this, and there is the wiki). > > - Finish the 'cld' manual (mostly done). > > - Update the 'xml' mkiv manual (doable, maybe users have examples too). > > - Finish the updated 'mathml' manual (done but needs checking but then I might overhaul the whole lot again). > > - Finish the more technical 'mkiv font' manual (tedious job but okay). > > - Pickup the 'stylistics' manual (also nice to do but a bit tedious). > > - Turn 'hybrid' into a more finished document (the second part of the history of mkiv/luatex). > > - Add more to the 'about' series (the third part). > > Of course this is too ambitious but it's good to remind myself that some work needs to be done. And ... users might have ideas of what needs to be done as well. > > Hans ___________________________________________________________________________________ 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 ___________________________________________________________________________________