Re: site javadocs and resolved issue 678

2006-11-03 Thread Doug Cutting
Chris Hostetter wrote: I stumbled upon this the other day... http://svn.apache.org/viewvc/lucene/java/nightly/ ...i don't know which host it runs on, or whether commiting changes to the nightly.sh will automatically put them into effect (or if it needs checked out somewhere) These are

Re: site javadocs and resolved issue 678

2006-11-03 Thread Chris Hostetter
: So, the upshot of this is we should not update docs on the site until : there is a release? Still, I think it would be nice to have a trunk : version hosted somewhere (as has been echoed by others) on the site +1 it sounds like we need to revert the docs at http://lucene.apache.org/java/docs

Re: site javadocs and resolved issue 678

2006-11-03 Thread Grant Ingersoll
So, the upshot of this is we should not update docs on the site until there is a release? Still, I think it would be nice to have a trunk version hosted somewhere (as has been echoed by others) on the site that could contain the nightly build docs. I can setup the links in the docs if so

RE: site javadocs and resolved issue 678

2006-10-31 Thread Steven Parkes
but i feel like the "default" should be the most bleeding edge stuff so more people can spot mistakes or ask questions about things that are confusing. In my experience, having API reference docs built out of trunk is very uncommon. In fact, I don't think I've ever seen it,

Re: site javadocs and resolved issue 678

2006-10-31 Thread Chris Hostetter
: 1. Site documentation is generated as part of Lucene build, and is : versioned with Lucene. : 2. Wiki documentation is not versioned with Lucene, and unrelated to the : build. : 3. Improvements to documentation would be nice to have in the public site : (e.g. scoring) even before released. : 4.

Re: site javadocs and resolved issue 678

2006-10-31 Thread Doron Cohen
Things get complicated because of relations/links between javadocs and other documentation. 1. Site documentation is generated as part of Lucene build, and is versioned with Lucene. 2. Wiki documentation is not versioned with Lucene, and unrelated to the build. 3. Improvements to documentation wou

Re: site javadocs and resolved issue 678

2006-10-31 Thread Sami Siren
Doug Cutting wrote: Actually the've typically been the current release. Hadoop updated its javadocs nightly before its first release, but now they're the current release. Solr may update it's nightly, but then it doesn't yet have any releases. And Nutch and Lucene's hosted javadocs are tradi

Re: site javadocs and resolved issue 678

2006-10-30 Thread Doug Cutting
Yonik Seeley wrote: Yes, the JavaDocs for Lucene, Solr, Hadoop, Nutch are populated during the nightly build process. Actually the've typically been the current release. Hadoop updated its javadocs nightly before its first release, but now they're the current release. Solr may update it's n

Re: site javadocs and resolved issue 678

2006-10-30 Thread Yonik Seeley
On 10/30/06, Chris Hostetter <[EMAIL PROTECTED]> wrote:> i thought there was a cron that took care of doing that on a regular basis? Yes, the JavaDocs for Lucene, Solr, Hadoop, Nutch are populated during the nightly build process. ...perhaps the same cron that does/did the nightly builds? ...

Re: site javadocs and resolved issue 678

2006-10-30 Thread Doron Cohen
> I _believe_ javadocs are for the latest released version (2.0). I thought not, because they are titled "Lucene 2.1-dev API", and also because they contain, e.g., LockFactory, which I think was not in 2.0. - To unsubscribe, e-m

Re: site javadocs and resolved issue 678

2006-10-30 Thread Chris Hostetter
: Hmmm, I updated them when I added in scoring docs (I kept the old : directories around, though) and they were based on trunk at the time : I did it. I wasn't aware of them being the latest released version, : but I can restore them to that easily enough. I believe they have allways been based

Re: site javadocs and resolved issue 678

2006-10-30 Thread Grant Ingersoll
By the looks of http://wiki.apache.org/jakarta-lucene/ReleaseTodo it should be the latest release.However, this breaks some of the links in the scoring documentation. Shall I revert the javadocs or should I revert the scoring docs or should we just leave things as is for now with the a

Re: site javadocs and resolved issue 678

2006-10-30 Thread Grant Ingersoll
Hmmm, I updated them when I added in scoring docs (I kept the old directories around, though) and they were based on trunk at the time I did it. I wasn't aware of them being the latest released version, but I can restore them to that easily enough. It might be nice to have two versions of

Re: site javadocs and resolved issue 678

2006-10-30 Thread Chris Hostetter
: I _believe_ javadocs are for the latest released version (2.0). No ... they say "Lucene 2.1-dev API" in the title, and where last modified on October 10th ... several post 2.0 things are listed (like Fieldable). Something definitely seems to have gone wrong in teh nightly generation ... but i

Re: site javadocs and resolved issue 678

2006-10-30 Thread Otis Gospodnetic
I _believe_ javadocs are for the latest released version (2.0). Otis - Original Message From: Doron Cohen <[EMAIL PROTECTED]> To: java-dev@lucene.apache.org Sent: Monday, October 30, 2006 5:03:49 PM Subject: site javadocs and resolved issue 678 I just noticed that current javadocs in h