Robert Burrell Donkin wrote: > recent experience suggests that the incubator documentation does a > poor job of helping podlings understand the difference between guides > and policy > > the first section in http://incubator.apache.org/guides/index.html is > terse and obtuse. one possibility would be to expand this. it would > also be possible to create a meta guide (guideance about seeking > guideance). > > opinions? > > suggestions?
The Incubation Guides linked below are descriptive and at times discursive documents. They describe current, but not necessarily best, practices. These guides are informational, to give you something to start from and improve over. Unlike the <a href="/incubation/Incubation_Policy.html">Policy</a>, the guides are <i>not</i> normative. You MAY diverge from a guide whenever it makes sense for your project. Only the <a href="/incubation/Incubation_Policy.html">Policy</a> is normative and MUST be followed by all projects. (and move the Notes section to the bottom of the page) (keywords MAY and MUST used as per RFC 2119 [1]) cheers, Roland [1] http://tools.ietf.org/html/rfc2119 --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
