From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.comp.tex.context/88174 Path: news.gmane.org!not-for-mail From: Henning Hraban Ramm Newsgroups: gmane.comp.tex.context Subject: Re: State of documentation of ConTeXt? Date: Mon, 21 Jul 2014 09:07:58 +0600 Message-ID: References: <1642f57885676cbd1020027a2bff7c40.squirrel@webmail.xs4all.nl> <53C41372.7080802@wxs.nl> Reply-To: mailing list for ConTeXt users NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 (Mac OS X Mail 7.3 \(1878.6\)) Content-Type: text/plain; charset="windows-1252" Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1405912104 12629 80.91.229.3 (21 Jul 2014 03:08:24 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 21 Jul 2014 03:08:24 +0000 (UTC) To: mailing list for ConTeXt users Original-X-From: ntg-context-bounces@ntg.nl Mon Jul 21 05:08:20 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 1X93xb-0004mC-Q0 for gctc-ntg-context-518@m.gmane.org; Mon, 21 Jul 2014 05:08:19 +0200 Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id 1B5781021F for ; Mon, 21 Jul 2014 05:08:19 +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 BvnbPO4nzWax for ; Mon, 21 Jul 2014 05:08:19 +0200 (CEST) Original-Received: from balder.ntg.nl (localhost [IPv6:::1]) by balder.ntg.nl (Postfix) with ESMTP id 852E610220 for ; Mon, 21 Jul 2014 05:08:11 +0200 (CEST) Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id 6300E101E6 for ; Mon, 21 Jul 2014 05:08:08 +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 DwhBwJeMC4IO for ; Mon, 21 Jul 2014 05:08:03 +0200 (CEST) Original-Received: from filter1-til.mf.surf.net (filter1-til.mf.surf.net [194.171.167.217]) by balder.ntg.nl (Postfix) with ESMTP id 8D13B101E1 for ; Mon, 21 Jul 2014 05:08:03 +0200 (CEST) Original-Received: from thesan.fiee.net (thesan.fiee.net [178.77.74.245]) by filter1-til.mf.surf.net (8.14.3/8.14.3/Debian-9.4) with ESMTP id s6L382nR017881 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT) for ; Mon, 21 Jul 2014 05:08:02 +0200 DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=default; d=fiee.net; b=SKNKNFLz1cdy1o6/Mvu1jMEZJhSx/gaDc8Mbs8W1zh6lAaDlagxgeo5vvHBIb+e5h0bvBmTm061jqHBMXMhRlH0nuM6Hkrad5D7Ml6OhgDCvO+cmum29b5UN1cDTMuik; h=Received:Received:Content-Type:Mime-Version:Subject:From:In-Reply-To:Date:Content-Transfer-Encoding:Message-Id:References:To:X-Mailer; Original-Received: (qmail 19544 invoked from network); 21 Jul 2014 05:08:02 +0200 Original-Received: from 176-123-225-41.maxlink.kg (HELO ?192.168.0.100?) (176.123.225.41) by thesan.fiee.net with ESMTPSA (AES128-SHA encrypted, authenticated); 21 Jul 2014 05:08:02 +0200 In-Reply-To: X-Mailer: Apple Mail (2.1878.6) X-Bayes-Prob: 0.0001 (Score 0, tokens from: ntg-context@ntg.nl, base:default, @@RPTN) X-CanIt-Geo: ip=178.77.74.245; country=DE; region=North Rhine-Westphalia; city=Host; latitude=51.6500; longitude=6.1833; http://maps.google.com/maps?q=51.6500,6.1833&z=6 X-CanItPRO-Stream: uu:ntg-context@ntg.nl (inherits from uu:default, base:default) X-Canit-Stats-ID: 0RMsP82Dr - 3f14d0f90e76 - 20140721 (trained as not-spam) X-Scanned-By: CanIt (www . roaringpenguin . com) on 194.171.167.217 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:88174 Archived-At: Am 2014-07-21 um 03:07 schrieb Gerben Wierda : >> My estimate would be that a complete context reference with >> well-described options and including trivial examples would require >> cca. 10.000-50.000 pages. Maybe others have different estimates, but >> now do the math. (Existing manuals like MetaFun or the old cont-en.pdf >> are roughly 400 pages. But that's nowhere near 10 % of the ConTeXt >> functionality. One would need to document the whole TeX part, the >> whole metapost part, the whole lua part, the whole xml, all perl, ruby >> and lua scripts, write better man pages, probably list the whole >> Unicode to show the ConTeXt names in one appendix =85) > = > If a tool needs 50.000 pages to document its use, you are in trouble (in = more ways than one). = > = > I think in reality a set of manuals, with core functionality and all kind= s of extras a manual of 500 pages and maybe a reference manual of the same = size would be something useful and thus meaningful. Stuff like MetaFun can = have its own manual and doesn=92t need to be in a core ConTeXt manual. > = > A user manual is enough. You don=92t need a developer manual. So, documen= ting all the development you can do with ConTeXt (programming in lua and wh= atnot) would for me not be what is needed for a user manual. What a user ma= nual does is what cont-en.pdf does, but then up to date and complete. If I might chime in =85 What we really need (and what =84simple=93 users like me cannot write, even= if I sometimes look into the sources) is a usable command reference, cover= ing all =84usable=93 commands and all their =84usable=93 options (i.e. omit= too experimental stuff). What we have on the wiki now is much too incomplete in all regards. I don= =92t know if there=92s something (more?) that can be automated. I don=92t know if Hans, Taco or Wolfgang (any other candidates?) would be a= ble and willing to do that work, if e.g. DANTE would fund it. Would you, an= d what do you think how much funding would be required to at least document= the current state of MkIV? I would not try to write a (printed/printable) reference manual for ConTeXt= , that really makes not much sense. We don=92t need to argue about page estimates, that depends too much on lay= out anyway =85 I thought the previous ConTeXt meeting was about documentation? Didn=92t yo= u agree on a better wiki structure? Greetlings, Hraban --- http://www.fiee.net/texnique/ http://wiki.contextgarden.net https://www.cacert.org (I'm an assurer) ___________________________________________________________________________= ________ 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 ___________________________________________________________________________= ________