incubator-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Dan Diephouse <...@envoisolutions.com>
Subject Re: [doc] call for feedback for http://incubator.apache.org/guides/proposal.html
Date Tue, 19 Sep 2006 18:32:36 GMT
This is very good Robert. Comments inline:

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).
>
> feedback would be very much appreciated. as always, if anyone can see
> any improvements please post a patch to this list, open a JIRA or (if
> you have karma) dive in.
>
> but in particular please reply with feedback about:
>
> 1 presentation (is the way the content presented easily digested and
> understandable?)

Yup.

>
> 2 commentary (is the commentary on the template generally too long,
> too short or just about right?)
>
Seems just right to me.

> 3 examples (would more examples and/or long examples improve the
> document or (conversely) are the examples too verbose at present?)
>
The examples are very helpful. Definitely not too verbose!

> 4 style changes (blue for notes)
>
The styling makes it very clear whats an example and whats not. I like it.

Cheers,
- Dan

-- 
Dan Diephouse
(616) 971-2053
Envoi Solutions LLC
http://netzooid.com


---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Mime
View raw message