[jira] [Comment Edited] (MAHOUT-1585) Javadocs are not hosted By Mahout Quality

["Suneel Marthi (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/MAHOUT-1585?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14386895#comment-14386895 ] 

Suneel Marthi edited comment on MAHOUT-1585 at 3/30/15 3:54 PM:
----------------------------------------------------------------

I heard from the Flink Team and below's what they r doing for hosting Javadocs and Scaladocs. I don't have the breathing space to work on this, if someone would like to volunteer please feel free.

{Code}

Flink documentation is built nightly via Buildbot provided by the Apache Infra team. Basically, you would create a Python config file for Mahout which defines a set of builders. You can check out Flink's config file as an example of how to build and publish docs [0]. There is also a README [1]. These builders [2] are then loaded into the global Buildbot config via the projects.conf file [3].

The tricky part about this setup is that the Buildbot config is loaded into a global namespace. So you have to be careful with syntax errors and duplicate variable names. Actual debugging is only possible via the help of the Apache Infra team. Their IRC channel has proven to be very helpful [4].

{Code}

[0] https://svn.us.apache.org/repos/infra/infrastructure/buildbot/aegis/buildmaster/master1/projects/flink.conf
[1] https://svn.us.apache.org/repos/infra/infrastructure/buildbot/aegis/buildmaster/master1/projects/readme.txt
[2] https://svn.us.apache.org/repos/infra/infrastructure/buildbot/aegis/buildmaster/master1/projects
[3] https://svn.us.apache.org/repos/infra/infrastructure/buildbot/aegis/buildmaster/master1/projects/projects.conf
[4] https://www.hipchat.com/g7itl962x




was (Author: smarthi):
I heard from the Flink Team and below's what they r doing for hosting Javadocs and Scaladocs. I don't have the breathing space to work on this, if someone would like to volunteer please feel free.

{Code}

Flink documentation is built nightly via Buildbot provided by the Apache Infra team. Basically, you would create a Python config file for Mahout which defines a set of builders. You can check out Flink's config file as an example of how to build and publish docs [0]. There is also a README [1]. These builders [2] are then loaded into the global Buildbot config via the projects.conf file [3].

The tricky part about this setup is that the Buildbot config is loaded into a global namespace. So you have to be careful with syntax errors and duplicate variable names. Actual debugging is only possible via the help of the Apache Infra team. Their IRC channel has proven to be very helpful [4].

[0] https://svn.us.apache.org/repos/infra/infrastructure/buildbot/aegis/buildmaster/master1/projects/flink.conf
[1] https://svn.us.apache.org/repos/infra/infrastructure/buildbot/aegis/buildmaster/master1/projects/readme.txt
[2] https://svn.us.apache.org/repos/infra/infrastructure/buildbot/aegis/buildmaster/master1/projects
[3] https://svn.us.apache.org/repos/infra/infrastructure/buildbot/aegis/buildmaster/master1/projects/projects.conf
[4] https://www.hipchat.com/g7itl962x

{Code}

> Javadocs are not hosted By Mahout Quality
> -----------------------------------------
>
>                 Key: MAHOUT-1585
>                 URL: https://issues.apache.org/jira/browse/MAHOUT-1585
>             Project: Mahout
>          Issue Type: Bug
>          Components: Documentation
>            Reporter: Andrew Palumbo
>            Assignee: Suneel Marthi
>              Labels: DSL, legacy, scala, spark
>             Fix For: 0.10.0
>
>
> The links to Javadocs for Math, Integration and Examples are all redirected to a password protected Build page. MR-Legacy is currently the only Javadoc being published and hosted by Mahout-Quality



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)