I have created issue https://issues.apache.org/jira/browse/MAHOUT-1461
Will upload shell scripts and suggested replacement text later tonight …. SCott On 3/13/14, 10:43 AM, "Sebastian Schelter" <[email protected]> wrote: >Hi Scott, > >Create a jira ticket and attach your scripts and a text version of the >page there. > >Best, >Sebastian > > >On 03/12/2014 03:27 PM, Scott C. Cote wrote: >> I took the tour of the text analysis and pushed through despite the >> problems on the page. Commiters helped me over the hump where others >> might have just gave up (to your point). >> When I did it, I made shell scripts so that my steps would be repeatable >> with an anticipation of updating the page. >> >> Unforunately, I gave up on trying to figure out how to update the page >> (there were links indicating that I could do it), and I didn¹t want to >> appear to be stupid asking how to update the documentation (my bad - not >> anyone else). Now I know that it was not possible unless I was a >>commiter. >> >> Who should I send my scripts to, or how should I proceed with a current >> form of the page? >> >> SCott >> >> On 3/12/14, 5:02 AM, "Sebastian Schelter" <[email protected]> wrote: >> >>> Hi Pavan, >>> >>> Awesome that you're willing to help. The documentation are the pages >>> listed under "Clustering" in the navigation bar under mahout.apache.org >>> >>> If you start working on one of the pages listed there (e.g. the k-Means >>> doc), please created jira ticket in our issue tracker with a title >>>along >>> the lines of "Cleaning up the documentation for k-Means on the >>>website". >>> >>> Put a list of errors and corrections into the jira and I (or some other >>> committer) will make sure to fix the website. >>> >>> Thanks, >>> Sebastian >>> >>> >>> On 03/12/2014 08:48 AM, Pavan Kumar N wrote: >>>> i ll help with clustering algorithms documentation. do send me old >>>> documentation and i will check and remove errors. or better let me >>>>know >>>> how to proceed. >>>> >>>> Pavan >>>> On Mar 12, 2014 12:35 PM, "Sebastian Schelter" <[email protected]> wrote: >>>> >>>>> Hi, >>>>> >>>>> As you've probably noticed, I've put in a lot of effort over the last >>>>> days >>>>> to kickstart cleaning up our website. I've thrown out a lot of stuff >>>>> and >>>>> have been startled by the amout of outdated and incorrect information >>>>> on >>>>> our website, as well as links pointing to nowhere. >>>>> >>>>> I think our lack of documentation makes it superhard to use Mahout >>>>>for >>>>> new >>>>> people. A crucial next step is to clean up the documentation on >>>>> classification and clustering. I cannot do this alone, because I >>>>>don't >>>>> have >>>>> the time and I'm not so familiar with the background of the >>>>>algorithms. >>>>> >>>>> I need volunteers to go through all the pages under "Classification" >>>>> and >>>>> "Clustering" on the website. For the algorithms, the content and >>>>> claims of >>>>> the articles need to be checked, for the examples we need to make >>>>>sure >>>>> that >>>>> everything still works as described. It would also be great to move >>>>> articles from personal blogs to our website. >>>>> >>>>> Imagine that some developer wants to try out Mahout and takes one >>>>>hour >>>>> for >>>>> that in the evening. She will go to our website, download Mahout, >>>>>read >>>>> the >>>>> description of an algorithm and try to run an example. In the current >>>>> state >>>>> of the documentation, I'm afraid that most people will walk away >>>>> frustrated, because the website does not help them as it should. >>>>> >>>>> Best, >>>>> Sebastian >>>>> >>>>> PS: I will make my standpoint on whether Mahout should do a 1.0 >>>>>release >>>>> depend on whether we manage to clean up and maintain our >>>>>documentation. >>>>> >>>> >>> >> >> >
