Return-Path: Delivered-To: apmail-incubator-lucy-dev-archive@www.apache.org Received: (qmail 39927 invoked from network); 5 Nov 2010 17:03:44 -0000 Received: from unknown (HELO mail.apache.org) (140.211.11.3) by 140.211.11.9 with SMTP; 5 Nov 2010 17:03:44 -0000 Received: (qmail 32462 invoked by uid 500); 5 Nov 2010 17:04:15 -0000 Delivered-To: apmail-incubator-lucy-dev-archive@incubator.apache.org Received: (qmail 32438 invoked by uid 500); 5 Nov 2010 17:04:15 -0000 Mailing-List: contact lucy-dev-help@incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: lucy-dev@incubator.apache.org Delivered-To: mailing list lucy-dev@incubator.apache.org Received: (qmail 32426 invoked by uid 99); 5 Nov 2010 17:04:15 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 05 Nov 2010 17:04:15 +0000 X-ASF-Spam-Status: No, hits=2.9 required=10.0 tests=HTML_MESSAGE,RCVD_IN_DNSWL_NONE,SPF_NEUTRAL X-Spam-Check-By: apache.org Received-SPF: neutral (nike.apache.org: local policy) Received: from [74.125.82.175] (HELO mail-wy0-f175.google.com) (74.125.82.175) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 05 Nov 2010 17:04:08 +0000 Received: by wya21 with SMTP id 21so3476818wya.6 for ; Fri, 05 Nov 2010 10:03:48 -0700 (PDT) MIME-Version: 1.0 Received: by 10.227.132.206 with SMTP id c14mr1600784wbt.78.1288976627293; Fri, 05 Nov 2010 10:03:47 -0700 (PDT) Received: by 10.216.64.4 with HTTP; Fri, 5 Nov 2010 10:03:47 -0700 (PDT) Received: by 10.216.64.4 with HTTP; Fri, 5 Nov 2010 10:03:47 -0700 (PDT) In-Reply-To: References: <20101104233058.GA14330@rectangular.com> <4CD427DD.5000001@peknet.com> Date: Fri, 5 Nov 2010 10:03:47 -0700 Message-ID: From: Nathan Kurz To: lucy-dev@incubator.apache.org Content-Type: multipart/alternative; boundary=0016e659f6f8fe5dde0494514190 X-Virus-Checked: Checked by ClamAV on apache.org Subject: Re: [lucy-dev] Generalize Tutorial for multiple host languages --0016e659f6f8fe5dde0494514190 Content-Type: text/plain; charset=UTF-8 I was about to write the same thing as Peter just did: don't generalize a tutorial, rather provide a native version per language with a many real world examples as possible. It's OK if you also want to have a meta tutorial as a template guide for developers (although maybe this is the same as the C guide) but don't try to make a single doc that covers both C and Ruby. Make each one feel as native as it can. You're a clownfish, tolerated by your host and immune to its poisons, not some generic marauding tube bass that causes everyone to cower in the kelp. Nathan Kurz nate@verse.com On Nov 5, 2010 8:51 AM, "Peter Karman" wrote: --0016e659f6f8fe5dde0494514190--