ok On 3/12/14, 9:58 AM, "Andrew Musselman" <andrew.mussel...@gmail.com> wrote:
>Thanks Scott; please just attach your work to an issue in the Jira >system; if there's not one already you could file a new issue. > >> On Mar 12, 2014, at 7:44 AM, "Scott C. Cote" <scottcc...@gmail.com> >>wrote: >> >> I’ll make it work. >> Don’t know markdown (assume some reduced mark”up” language) - but I’ll >> figure it out. I will assume that I can check with my consulting buddy >> “Google” and find it. :) >> >> Thank you for your contributions - glad that I can give “something” >>back. >> I’ll start off by sending the doc to one of the committers, and then if >> you guys like my work, then we can proceed from there …. >> >> SCott >> >>> On 3/12/14, 9:38 AM, "Sebastian Schelter" <s...@apache.org> wrote: >>> >>> Hi Scott, >>> >>> The cms behind the website uses markdown. So ideally you would attach a >>> textfile with markdown formattings to a jira issue and a committer will >>> put that into the website. >>> >>> Does that work for you? >>> >>> PS: There are a lot of online markdown editors out there. >>> >>>> 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" <s...@apache.org> 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" <s...@apache.org> >>>>>>>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. >> >>
