On 8/23/13 11:10 AM, Peter Hartmann wrote: > On 23.08.2013 16:59 Wayne Witzel III <wwitz...@gmail.com> wrote: > >> I'm waiting to get clarification on the release documentation before I vote. >> > > That's not an issue for me, but I'd like to hear about it too, so while I plan > to vote I held myself for now. > > As I see it, release documentation describe new features and incompatibilities > in a less technical way that i.e. CHANGES. But this is our first release, so > it's not like we have particularly much to describe. Every feature is "new" > (previously unreleased) and there is no earlier version to be incompatible > with. >
I agree. I think its something we can compile with more details for future releases. Chris Tsai wrote: > Perhaps the README file should to be tweaked? Currently, its install > instructions > indicate obtaining latest source via git, instead of how to install the > versioned release they just downloaded. That makes sense, although the README is useful for folks that do a git clone or are browsing the repo over the web too. So we'd want to accommodate having the source already, getting the latest, or downloading an official release. http://incubator.apache.org/guides/releasemanagement.html#best-practice-documentation describes guidelines and best practices, so I think these are perfect items for improvement for our next release, and no reason to stop a first release. -- Dave Brondsema : d...@brondsema.net http://www.brondsema.net : personal http://www.splike.com : programming <><
