From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.comp.tex.context/88126 Path: news.gmane.org!not-for-mail From: "Rob Heusdens" Newsgroups: gmane.comp.tex.context Subject: Re: State of documentation of ConTeXt? Date: Wed, 16 Jul 2014 13:24:59 +0200 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 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1405509925 3812 80.91.229.3 (16 Jul 2014 11:25:25 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 16 Jul 2014 11:25:25 +0000 (UTC) To: "mailing list for ConTeXt users" Original-X-From: ntg-context-bounces@ntg.nl Wed Jul 16 13:25:21 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 1X7NKn-0003c7-V1 for gctc-ntg-context-518@m.gmane.org; Wed, 16 Jul 2014 13:25:18 +0200 Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id 8A8F910280 for ; Wed, 16 Jul 2014 13:25:17 +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 LGhUiCy09sel for ; Wed, 16 Jul 2014 13:25:17 +0200 (CEST) Original-Received: from balder.ntg.nl (localhost [IPv6:::1]) by balder.ntg.nl (Postfix) with ESMTP id 1D96E10220 for ; Wed, 16 Jul 2014 13:25:10 +0200 (CEST) Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id 03601101E3 for ; Wed, 16 Jul 2014 13:25:06 +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 iNYuXUj-HOEP for ; Wed, 16 Jul 2014 13:25:00 +0200 (CEST) Original-Received: from filter4-til.mf.surf.net (filter4-til.mf.surf.net [194.171.167.220]) by balder.ntg.nl (Postfix) with ESMTP id 87ED0101E2 for ; Wed, 16 Jul 2014 13:25:00 +0200 (CEST) Original-Received: from smtp-vbr11.xs4all.nl (smtp-vbr11.xs4all.nl [194.109.24.31]) by filter4-til.mf.surf.net (8.14.3/8.14.3/Debian-9.4) with ESMTP id s6GBOxC6030856 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT) for ; Wed, 16 Jul 2014 13:24:59 +0200 Original-Received: from webmail.xs4all.nl (dovemail19.xs4all.nl [194.109.26.21]) by smtp-vbr11.xs4all.nl (8.13.8/8.13.8) with ESMTP id s6GBOxHH092748 for ; Wed, 16 Jul 2014 13:24:59 +0200 (CEST) (envelope-from robheus@xs4all.nl) Original-Received: from 82.95.176.15 (SquirrelMail authenticated user robheus) by webmail.xs4all.nl with HTTP; Wed, 16 Jul 2014 13:24:59 +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.31; 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: 0VMqXoXjx - 7fc9093e6a5e - 20140716 (trained as not-spam) X-Scanned-By: CanIt (www . roaringpenguin . com) on 194.171.167.220 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:88126 Archived-At: > I agree that it would be awesome if there was complete documentation > available + maybe three manuals/tutorials from beginner to master, but > you cannot expect it from Hans to do all the work on his own. > > Mojca > I think that part of the work has to be done by other volunteers (users), who have enough experience to write in good style user documentation. That kind of work does not depend on Hans or Taco alone. I think their important task is to have the technical documentation up-to-date and/or provide well enough information about the changes in releases, that others can write good user-documentation. First priority I guess would be to have the contextgarden Wiki up-to-date: many commands and/or parameters are not touched there. There are many outdate pages (with broken links, etc.), and definatately I would guess a better split is needed between MkII and MkIV wherever applicable. If time and experience-level allows me, I would like to start working on that kind of things. Someday I would also like to write a user-manual for Context novices (and ppl. new to Tex in general). But first I need to sort out some things myself, esp. about the whole font-mechanism, and how Context handles it. And as of yet I have no clue on what is what in the Context/Tex tree and where to find all the sources. Keeps me busy some time... Greetings, Rob -------- PS. And also material on 'good typography' would come in handy as weblinks and in Context user-manuals. Yesterday, I read this online typography manual, which contains some usefull tips about Typography. See: http://practicaltypography.com/index.html#toc I see that he also uses protrusion in the left-margin for quotations (when you start a sentence on a new line with a quotation), something which Context atm. does not do, only in the right margin, but the result is good. Definately some feature request. ___________________________________________________________________________________ > 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-context webpage : http://www.pragma-ade.nl / http://tex.aanhet.net archive : http://foundry.supelec.fr/projects/contextrev/ wiki : http://contextgarden.net ___________________________________________________________________________________