From general-return-11015-apmail-incubator-general-archive=incubator.apache.org@incubator.apache.org Tue Sep 19 15:35:14 2006 Return-Path: Delivered-To: apmail-incubator-general-archive@www.apache.org Received: (qmail 67453 invoked from network); 19 Sep 2006 15:35:13 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 19 Sep 2006 15:35:13 -0000 Received: (qmail 57275 invoked by uid 500); 19 Sep 2006 15:35:07 -0000 Delivered-To: apmail-incubator-general-archive@incubator.apache.org Received: (qmail 57113 invoked by uid 500); 19 Sep 2006 15:35:06 -0000 Mailing-List: contact general-help@incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: general@incubator.apache.org Delivered-To: mailing list general@incubator.apache.org Received: (qmail 56998 invoked by uid 99); 19 Sep 2006 15:35:06 -0000 Received: from idunn.apache.osuosl.org (HELO idunn.apache.osuosl.org) (140.211.166.84) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 19 Sep 2006 08:35:06 -0700 Authentication-Results: idunn.apache.osuosl.org header.from=matthieu.riou@gmail.com; domainkeys=good X-ASF-Spam-Status: No, hits=0.5 required=5.0 tests=DNS_FROM_RFC_ABUSE,HTML_30_40,HTML_MESSAGE,RCVD_BY_IP DomainKey-Status: good X-DomainKeys: Ecelerity dk_validate implementing draft-delany-domainkeys-base-01 Received: from ([64.233.182.184:59867] helo=nf-out-0910.google.com) by idunn.apache.osuosl.org (ecelerity 2.1 r(10620)) with ESMTP id 31/A1-28275-42E00154 for ; Tue, 19 Sep 2006 08:35:02 -0700 Received: by nf-out-0910.google.com with SMTP id x4so195743nfb for ; Tue, 19 Sep 2006 08:34:58 -0700 (PDT) DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=beta; d=gmail.com; h=received:message-id:date:from:reply-to:to:subject:in-reply-to:mime-version:content-type:references; b=Vq+LoalpbDevPpUOnf1f1fYj0dE38px0cfS9YUqeh7CqEkqfVEQkFCdfkSQxLVut2j69JUX+FVIkT5KdnFvNTZfaIfEvNd1PB3RtBm7dODVOt4ylOvEagvi11b1E0gRhfHmTvl0Dn4yShn1DBdx6eLmaa5qp4XMp8XjKPpMa34Y= Received: by 10.48.162.15 with SMTP id k15mr18550750nfe; Tue, 19 Sep 2006 08:34:57 -0700 (PDT) Received: by 10.49.51.3 with HTTP; Tue, 19 Sep 2006 08:34:57 -0700 (PDT) Message-ID: Date: Tue, 19 Sep 2006 08:34:57 -0700 From: "Matthieu Riou" Reply-To: matthieu.riou@gmail.com To: general@incubator.apache.org Subject: Re: [doc] call for feedback for http://incubator.apache.org/guides/proposal.html In-Reply-To: <5c902b9e0609190829n7b62a6d7ka0c6bd358bb4884b@mail.gmail.com> MIME-Version: 1.0 Content-Type: multipart/alternative; boundary="----=_Part_5426_2222216.1158680097430" References: <5c902b9e0609190829n7b62a6d7ka0c6bd358bb4884b@mail.gmail.com> X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N ------=_Part_5426_2222216.1158680097430 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Content-Disposition: inline It's really good, I like the template a lot. It will probably be very helpful. And I agree that a TOC would be helpful. On 9/19/06, Justin Erenkrantz wrote: > > On 9/18/06, robert burrell donkin wrote: > > http://incubator.apache.org/guides/proposal.html is currently a > > draft document. i think that it's strong enough to push towards > > promoting it (and putting it in the indexes). > > +1. > > > 1 presentation (is the way the content presented easily digested and > > understandable?) > > Two small comments for your consideration. > > First, what about a TOC at the beginning that links to the other > sections of the documents? That way people have an idea of the > sections - but this document is long enough that a TOC is nice to > have. > > The other thing that I would find helpful is to change the color of > the examples and commentary. They are way too similar. Maybe one of > them should be boxed with a dark-color background? It's a minor nit, > but I think if we can make the distinction greater (the font > difference isn't enough, IMO), it'd be easier to understand. > (Actually, if I look at it, I think you may have tried with a > light-blue and white? If so, the color difference is too subtle.) > > Even with these minor nits, this is certainly good enough to link from > the main page. Thanks so much - this is going to be a great help! -- > justin > > --------------------------------------------------------------------- > To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org > For additional commands, e-mail: general-help@incubator.apache.org > > ------=_Part_5426_2222216.1158680097430--