On Sat, Dec 21, 2013 at 06:28:53PM -0800, Suneel Marthi wrote: > [...] Intro sound good to me.
> In > addition to the release highlights and artifacts, please pay attention > to the section labelled FUTURE PLANS below for more information about > upcoming releases of Mahout. For this release I'd cut this highlight. It was important in 0.8 to point out why implementations were removed, this time I don't see a need to focus attention on future plans. > RELEASE HIGHLIGHTS > > The highlights of the Apache Mahout 0.9 release include, but are not > limited to the list below. For further information, see the included > CHANGELOG file. > > - Scala DSL Bindings for Mahout Math Linear Algebra (MAHOUT-1297). > See > http://weatheringthrutechdays.blogspot.com/2013/07/scala-dsl-for-mahout-in-core-linear.html Assuming this was committed to trunk, can we please migrate the documentation to the Apache CMS based site as well? I'm not particularly comfortable having barely documented stuff in our code base. Also list the JIRA issue. If this is nothing that is part of the release, it should not be mentioned. > - New Multilayer Perceptron Classifier (MAHOUT-1265) I'd add a note here that this is an early implementation released to gather feedback but needs better integration with Mahout vectors etc. Also do we have documentation in the classification section of the Mahout site on this? Is there an example that shows how to use this? > - Recommenders as a Search (MAHOUT-1288). See > https://github.com/pferrel/solr-recommender Is this committed to trunk and part of the release? If not it should not be listed. I'm happy listing related projects on our main web page - however IMHO such stuff does not belong into the release notes. > - MAHOUT-1364: Upgrade Mahout to be Lucene 4.6.0 compliant > - MAHOUT-1361: Online Algorithm for computing accurate Quantiles using > 1-dimensional Clustering > See > https://github.com/tdunning/t-digest/blob/master/docs/theory/t-digest-paper/histo.pdf > for the details. Same as above - please migrate relevant documentation to our main web site instead of referencing stuff outside. At the very least there should be a link other than in the release notes to this document. > - Removed Deprecated algorithms. Add a note as to why they were deleted (not enough users, maintainers taking care, code quality issues etc.) > - the usual bug fixes. See JIRA [?} for more information on the 0.9 release. > > > A total 91 separate JIRA issues were addressed in this release. Maybe a coarse overview of the result? (Something along the lines of "better performance", "fixed bugs in existing implementations" etc) > The following algorithms that were marked deprecated in 0.8 have been removed > in 0.9: > [...] Sounds good to me. > > CONTRIBUTING > > Mahout > is always looking for contributions focused on the 3Cs. If you are > interested in contributing, please see our contribution page, > https://cwiki.apache.org/MAHOUT/how-to-contribute.html, on the Mahout wiki or > contact us via email at [email protected]. Don't link to the wiki here as this page will be gone soon. Rather point to http://mahout.apache.org/developers/how-to-contribute.html > FUTURE PLANS What happens in 1.0 mainly depends on what the community is interested in working on. As a result other than stuff that has been discussed and agreed upon firmly making future predictions is a very dangerous thing to do. I'd rather not include this section this time. Isabel
