Some incubator people have been recommending release notes. It made me think about the discussion we had about calling out non back compatible stuff in CHANGES.txt, and makes me think that should be the release notes. Put a higher level section at the top, with potentially a little more general info and how to migrade, and all the individual changes below. Some projects do it like this.
So, a proposed layout for our releases: solr/KEYS.txt solr/1.1/apache-solr-1.1.0-incubating.[zip,tgz,etc] solr/1.1/CHANGES.txt Then the website would be able to link directly to the CHANGES.txt as well as the archives. -Yonik
