geronimo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Hernan Cunico <>
Subject Re: Geronimo v2.1 documentation
Date Thu, 07 Feb 2008 18:47:18 GMT
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.


Kevan Miller wrote:
> Unless somebody is already working on it, I'm going to start updating 
> 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

View raw message