From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.comp.tex.context/84483 Path: news.gmane.org!not-for-mail From: Mari Voipio Newsgroups: gmane.comp.tex.context Subject: Re: Feedback wanted on a ConTeXt tutorial Date: Sun, 29 Sep 2013 21:41:23 +0300 Message-ID: References: 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 1380480091 466 80.91.229.3 (29 Sep 2013 18:41:31 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 29 Sep 2013 18:41:31 +0000 (UTC) To: mailing list for ConTeXt users Original-X-From: ntg-context-bounces@ntg.nl Sun Sep 29 20:41:36 2013 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 1VQLvy-0003QL-Mc for gctc-ntg-context-518@m.gmane.org; Sun, 29 Sep 2013 20:41:34 +0200 Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id 5A507101E9; Sun, 29 Sep 2013 20:39: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 qrPxmfQ7wZBA; Sun, 29 Sep 2013 20:39:14 +0200 (CEST) Original-Received: from balder.ntg.nl (localhost [IPv6:::1]) by balder.ntg.nl (Postfix) with ESMTP id B5A2A101DE; Sun, 29 Sep 2013 20:39:14 +0200 (CEST) Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id 061BB101DE for ; Sun, 29 Sep 2013 20:39:14 +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 ExtupZyil21O for ; Sun, 29 Sep 2013 20:39:09 +0200 (CEST) Original-Received: from filter3-til.mf.surf.net (filter3-til.mf.surf.net [194.171.167.219]) by balder.ntg.nl (Postfix) with ESMTP id 7318110193 for ; Sun, 29 Sep 2013 20:39:09 +0200 (CEST) Original-Received: from mail-wg0-x22e.google.com (mail-wg0-x22e.google.com [IPv6:2a00:1450:400c:c00::22e]) by filter3-til.mf.surf.net (8.14.3/8.14.3/Debian-9.4) with ESMTP id r8TIfNw0028168 for ; Sun, 29 Sep 2013 20:41:23 +0200 Original-Received: by mail-wg0-f46.google.com with SMTP id k14so4577584wgh.13 for ; Sun, 29 Sep 2013 11:41:23 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:date:message-id:subject :from:to:content-type; bh=aCR8GqRCGjC+iWpKUhM581MMorMhyWl5Zds2ewWXHTE=; b=wUq3LPE+orySTz1IS6w9iWhRLhDgxj67BZ3IapDCbbL+CRomaxiQywdEHtAlgDxxZ1 eI2pciEalle4bbjTLjx5BmjDSe+THG4+nqyVd7WQkTF39slD2EL3epGLSc8mh7jrjU6Y h1AwX6WyzKs2UHMY7EX4clwfKrFWJjyT24HYlixWPyGKkJxzh9e53CEzs52AbUeW5kZR YVnupLWzn7VePLCm3h9nsoQz+XBXH9oysxOj0BNaGBWmEl1uSEpFW0/FLAiGyndrj46d 5Y9efgy7WjBtxKXxHkcqAhuJ4oKZBIgfIm7dU9iTna0ECrtZ0+U7ARSdii6kMTDIbVhl hTmg== X-Received: by 10.180.9.203 with SMTP id c11mr10698643wib.64.1380480083530; Sun, 29 Sep 2013 11:41:23 -0700 (PDT) Original-Received: by 10.194.76.10 with HTTP; Sun, 29 Sep 2013 11:41:23 -0700 (PDT) In-Reply-To: X-Google-Sender-Auth: J6FF_gm8x9bRuKNcSaQysvPW4vM X-Bayes-Prob: 0.0001 (Score 0, tokens from: @@RPTN) X-CanIt-Geo: ip=2a00:1450:400c:c00::22e; country=IE X-CanItPRO-Stream: uu:ntg-context@ntg.nl (inherits from uu:default, base:default) X-Canit-Stats-ID: 06Kv6Fnod - 271a8f196205 - 20130929 (trained as not-spam) X-Scanned-By: CanIt (www . roaringpenguin . com) 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:84483 Archived-At: Hi! On Sun, Sep 29, 2013 at 8:50 PM, Thangalin wrote: > - The introduction paragraph can be shortened. For example, tell the > reader to "try the subsequent examples using ConTeXt Live web page" > (as opposed to 'almost all of the examples in the series can be run > online'). On any example that does not work, indicate such at the > time. Darn, I forgot to change this one - I found that the sample graphics are found by ConTeXt Live, so *all* examples this far work online. I aim at keeping things that way. I'm not that happy with the intro anyway, your sentence is a lot more beautiful than mine. :-) > - Avoid using abbreviations and jargon. I thought I had, but obviously not enough. Will have to do a jargon check all over - I write one chapter at a time so minor discrepancies can be expected at this stage. > As Marco noted, why not apply such wonderful effort to the wiki? Because my idea is to make a document that allows one to start from the beginning and doing the examples in the order given. I used the wiki a lot to check on stuff, but it is not quite the same thing - and wiki's "second document" is already a real jump start to ConTeXt, I want to introduce things slower. I will try to improve the wiki when I stumble on problems. E.g. within last three days I've looked up half a dozen commands that are not on the command reference index (the longer one) even though they have a page of their own, e.g. \externalfigure (not on http://wiki.contextgarden.net/Category:Commands but has a page at http://wiki.contextgarden.net/Command/externalfigure). If the index is generated manually (as it seems), I can edit it and add missing commands on the go when I find them. I must admit that I find it a bit scary to edit the wiki; I'm always worried about messing up with somebody else's work - with this tutorial project I can only mess up with my own text and mostly I can live with that. Editing the wiki I think that everybody else must know better than I do, for my command of ConTeXt is fairly basic, so I can't see my solutions being better than those already existing. Thus I rarely log in to edit, except with failing links and other small issues. How should I phrase this? The wiki is like an encyclopedia, I look up stuff (more often than not with find) that I need for each case. My aim is to make something like a novel or a book used for learning the basics of a foreign language, introducing new things gradually. Thank you for your time and comments! Mari ___________________________________________________________________________________ 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 ___________________________________________________________________________________