Re: Javadocs?

2010-03-30 Thread Grant Ingersoll
Just like the docs (people.a.o: /www/lucene.apache.org/mahout/...), just copy 
them there and decompress.  In this case, delete the old ones

-Grant
On Mar 30, 2010, at 6:31 AM, Sean Owen wrote:

 How do we post files there? Happy to do it. For now I'm happy to just
 have one, latest copy available.
 
 On Tue, Mar 30, 2010 at 11:25 AM, Grant Ingersoll gsing...@apache.org wrote:
 I think I just dumped them in that directory.  If we want, we can keep move 
 aside the old ones and update the website to refer to each version.
 
 




Re: Javadocs?

2010-03-30 Thread Sean Owen
Done, they're all up under
http://lucene.apache.org/mahout/javadoc/mahout-{core,...}/index.html

I retained http://lucene.apache.org/mahout/javadoc/core/index.html via symlink.

On Tue, Mar 30, 2010 at 12:16 PM, Grant Ingersoll gsing...@apache.org wrote:
 Just like the docs (people.a.o: /www/lucene.apache.org/mahout/...), just copy 
 them there and decompress.  In this case, delete the old ones


Re: Javadocs?

2010-03-30 Thread Jake Mannix
Awesome, thanks guys.

Doesn't Maven do this kind of thing for us, if we tell it to?

(ie can't we also have daily updates of the 0.4-SNAPSHOT javadocs
automagically posted up there too?)

  -jake

On Tue, Mar 30, 2010 at 6:28 AM, Sean Owen sro...@gmail.com wrote:

 Done, they're all up under
 http://lucene.apache.org/mahout/javadoc/mahout-{core,...}/index.html

 I retained http://lucene.apache.org/mahout/javadoc/core/index.html via
 symlink.

 On Tue, Mar 30, 2010 at 12:16 PM, Grant Ingersoll gsing...@apache.org
 wrote:
  Just like the docs (people.a.o: /www/lucene.apache.org/mahout/...), just
 copy them there and decompress.  In this case, delete the old ones



Re: Javadocs?

2010-03-30 Thread Grant Ingersoll

On Mar 30, 2010, at 10:14 AM, Jake Mannix wrote:

 Awesome, thanks guys.
 
 Doesn't Maven do this kind of thing for us, if we tell it to?
 
 (ie can't we also have daily updates of the 0.4-SNAPSHOT javadocs
 automagically posted up there too?)

Yeah, we could.  We do have to be careful about publishing SNAPSHOT docs.  They 
have to be clearly labeled as development and likely listed as a dev. resource 
and not something that is officially released.  FWIW, in Lucene, we use Hudson 
to do these things.

We're probably to the point now that we could start doing a nightly on Hudson 
if we aren't already.

Re: Javadocs?

2010-03-30 Thread Isabel Drost
On Tue Grant Ingersoll gsing...@apache.org wrote:
 If we want, we can keep move aside the old ones and update the
 website to refer to each version.

I think that would be great - now that we are slowly getting to a point
where apis seem to stabilise at least a bit it would be great for users
that don't upgrade to still have the ability to find the docs for their
favourite version online.

Isabel



Re: Javadocs?

2010-03-30 Thread Isabel Drost
On Tue Jake Mannix jake.man...@gmail.com wrote:
 (ie can't we also have daily updates of the 0.4-SNAPSHOT javadocs
 automagically posted up there too?)

Yes - maven can do such a thing. I have configured a job on hudson to
generate code reports for Mahout with maven - Javadocs are one part of
these reports. 

Linked to from the code quality reports page:
http://lucene.apache.org/mahout/quality.html
Click on core - project reports - java doc for the following example:
http://hudson.zones.apache.org/hudson/userContent/lucene-mahout/core-reports/apidocs/index.html

Unfortunately I currently do not have the spare cycles to go there and
look why the job broke lately. Anyone with more time than myself and a
tiny little bit of maven knowledge would be more than welcome to help
out.

The link to the hudson job:
http://hudson.zones.apache.org/hudson/job/MahoutQM/


I would argue against publishing Snapshot JavaDocs too close besides
JavaDocs of official releases - it might trick users into thinking that
the SNAPSHOT is an official release as well... Just my two cents - the
community may feel otherwise.

Isabel



Re: Javadocs?

2010-03-30 Thread Isabel Drost
On Tue Grant Ingersoll gsing...@apache.org wrote:
 We're probably to the point now that we could start doing a nightly
 on Hudson if we aren't already.

http://hudson.zones.apache.org/hudson/job/Mahout%20nightly/

;) (At least this one tracks whether the project still builds and all
unit tests pass.)

The one for building reports, java docs et.al was configured to build
less often - which would be fine, I think - can be triggered manually
in case of major changes anyway.

Isabel


Javadocs?

2010-03-29 Thread Jake Mannix
Hey gang,

  Where are the 0.3 javadocs on the web?  All I can find right now are the
0.1's http://lucene.apache.org/mahout/javadoc/core/index.html.

  -jake


Re: Javadocs?

2010-03-29 Thread Sean Owen
Agree, how do we update that? i can do so.

On Mon, Mar 29, 2010 at 8:40 PM, Jake Mannix jake.man...@gmail.com wrote:
 Hey gang,

  Where are the 0.3 javadocs on the web?  All I can find right now are the
 0.1's http://lucene.apache.org/mahout/javadoc/core/index.html.

  -jake



[jira] Resolved: (MAHOUT-117) Add Javadocs to site

2009-12-11 Thread Sean Owen (JIRA)

 [ 
https://issues.apache.org/jira/browse/MAHOUT-117?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Sean Owen resolved MAHOUT-117.
--

Resolution: Duplicate

Really subsumed by MAHOUT-210

 Add Javadocs to site
 

 Key: MAHOUT-117
 URL: https://issues.apache.org/jira/browse/MAHOUT-117
 Project: Mahout
  Issue Type: Improvement
  Components: Website
Affects Versions: 0.2
Reporter: Otis Gospodnetic
Assignee: Sean Owen
 Fix For: 0.3


 There are no Javadocs on http://lucene.apache.org/mahout .

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.



[jira] Commented: (MAHOUT-117) Add Javadocs to site

2009-12-10 Thread Sean Owen (JIRA)

[ 
https://issues.apache.org/jira/browse/MAHOUT-117?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanelfocusedCommentId=12788761#action_12788761
 ] 

Sean Owen commented on MAHOUT-117:
--

Is this just a matter of checking in the javadoc tree under site/ and 
republishing (after creating a link, of course)? Anyone know a better way?

 Add Javadocs to site
 

 Key: MAHOUT-117
 URL: https://issues.apache.org/jira/browse/MAHOUT-117
 Project: Mahout
  Issue Type: Improvement
  Components: Website
Affects Versions: 0.2
Reporter: Otis Gospodnetic
Assignee: Sean Owen
 Fix For: 0.3


 There are no Javadocs on http://lucene.apache.org/mahout .

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.



[jira] Commented: (MAHOUT-117) Add Javadocs to site

2009-12-10 Thread Drew Farris (JIRA)

[ 
https://issues.apache.org/jira/browse/MAHOUT-117?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanelfocusedCommentId=12789087#action_12789087
 ] 

Drew Farris commented on MAHOUT-117:


The code quality reports Isabel is putting together as a part of MAHOUT-210 
include the javadocs, and these should be published for the nightlies and for 
each release. Perhaps it is as simple as linking to these from the site?

(see: 
http://people.apache.org/~isabel/mahout_site/mahout-core/apidocs/index.html)


 Add Javadocs to site
 

 Key: MAHOUT-117
 URL: https://issues.apache.org/jira/browse/MAHOUT-117
 Project: Mahout
  Issue Type: Improvement
  Components: Website
Affects Versions: 0.2
Reporter: Otis Gospodnetic
Assignee: Sean Owen
 Fix For: 0.3


 There are no Javadocs on http://lucene.apache.org/mahout .

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.



[jira] Updated: (MAHOUT-117) Add Javadocs to site

2009-12-09 Thread Sean Owen (JIRA)

 [ 
https://issues.apache.org/jira/browse/MAHOUT-117?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Sean Owen updated MAHOUT-117:
-

  Component/s: Website
Affects Version/s: 0.2
Fix Version/s: 0.3
 Assignee: Sean Owen

 Add Javadocs to site
 

 Key: MAHOUT-117
 URL: https://issues.apache.org/jira/browse/MAHOUT-117
 Project: Mahout
  Issue Type: Improvement
  Components: Website
Affects Versions: 0.2
Reporter: Otis Gospodnetic
Assignee: Sean Owen
 Fix For: 0.3


 There are no Javadocs on http://lucene.apache.org/mahout .

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.



No javadocs?

2009-04-14 Thread Otis Gospodnetic

Hello,

I just noticed there are no Javadocs on the site.  I generated them locally 
with mvn javadoc:javadoc.  I'll add a JIRA issue.

 Otis
--
Sematext -- http://sematext.com/ -- Lucene - Solr - Nutch



Re: No javadocs?

2009-04-14 Thread Grant Ingersoll



On Apr 14, 2009, at 5:04 PM, Otis Gospodnetic wrote:



Hello,

I just noticed there are no Javadocs on the site.  I generated them  
locally with mvn javadoc:javadoc.  I'll add a JIRA issue.


I think Sean put them up, but they may not be linked from the site  
just yet.  I know they do exist on people.a.o.  Sean?


Re: No javadocs?

2009-04-14 Thread Grant Ingersoll

OK, done.  Will take some time to propagate through the mirrors.

Note, now we need to add package level docs, etc.  ;-)

-Grant
On Apr 14, 2009, at 5:18 PM, Grant Ingersoll wrote:




On Apr 14, 2009, at 5:04 PM, Otis Gospodnetic wrote:



Hello,

I just noticed there are no Javadocs on the site.  I generated them  
locally with mvn javadoc:javadoc.  I'll add a JIRA issue.


I think Sean put them up, but they may not be linked from the site  
just yet.  I know they do exist on people.a.o.  Sean?