Hey Kevan,
It's OK to have some overlap between the release notes and the rest of the
wiki. We currently ship only the rel notes with the product, not the product
doc (wiki)
Most of the content on the rel notes should be based on the "what's new"
section. However that section is currently empty so we'll have to the other way around
and build that up from what we have in the release notes.
One thing I tried to do in the past but didn't pick up in popularity was to
have most of the release notes generated automatically. I mean you would work
some content out directly on the appropriate sections in the wiki and then the
release notes pulls in and builds up dynamically from that content. We would
just do some minor touch ups here and there. I think going this way is best as
will also foster greater level of contributions to the documentation.
Cheers!
Hernan
Kevan Miller wrote:
Unless somebody is already working on it, I'm going to start updating
the RELEASE_NOTES --
http://cwiki.apache.org/GMOxDOC21/release-notes-21txt.html
I'm noticing that the release notes have a good deal of overlap with the
README and other wiki documentation. I also see that we're not including
the README in our binary distributions. The README contains the "notice
regarding cryptographic software" -- this needs to be included in our
distribution.
I'm going to whittle down the RELEASE_NOTES to focus on specific
features of the current release. I'll update the README with current
information, and will make sure we're including the README in our
distributions.
--kevan
