Re: Hosted API docs update?

[Sai Boorlagadda]

Thanks Mark & Dave,

Yes I can see my changes in nightly build.

Sai

On Fri, Jan 13, 2017 at 2:37 PM, Dave Barnes  wrote:

> Thanks, Mark. So Sai, you should see your updates in the 1.1.0-snapshot API
> docs.
> It has been pointed out to me that the 'incubating' API docs are, in fact,
> current for 1.0.0, as the build occurred prior to graduation.
>
>
> On Fri, Jan 13, 2017 at 2:09 PM, Mark Bretl  wrote:
>
> > Latest development javadocs built with the nightly build and are
> available
> > at
> > https://builds.apache.org/view/G/view/Geode/job/Geode-
> > nightly/lastSuccessfulBuild/artifact/geode-assembly/build/
> > install/apache-geode/javadoc/
> >
> > --Mark
> >
> > On Fri, Jan 13, 2017 at 11:31 AM, Dave Barnes 
> wrote:
> >
> > > @Anthony Thanks for the pointer, but I guess I need a little more
> detail.
> > > When I look at the javadocs in my Geode source repo, I find a set at
> > > geode-assembly/build/javadocs that's labeled 1.1.0-SNAPSHOT.
> > > I went to the Geode website Releases page to download the binary
> > > distribution (http://geode.apache.org/releases/). It offers v
> > > 1.0.0-incubating.
> > >
> > >
> > >
> > > On Fri, Jan 13, 2017 at 11:01 AM, Sai Boorlagadda <
> > > sai.boorlaga...@gmail.com
> > > > wrote:
> > >
> > > > +1 to link API docs to release page.
> > > >
> > > > On Fri, Jan 13, 2017 at 10:42 AM, Anthony Baker 
> > > wrote:
> > > >
> > > > > +1
> > > > >
> > > > > I’d would like to link the docs + javadocs from the release page,
> > > similar
> > > > > to what we do for the release archives.
> > > > >
> > > > > Anthony
> > > > >
> > > > >
> > > > > > On Jan 13, 2017, at 10:39 AM, Joey McAllister <
> > > jmcallis...@pivotal.io>
> > > > > wrote:
> > > > > >
> > > > > > Do we also want to archive the API
> > > > > > documentation, so the Apache Geode 1.0 APIs are still available
> > when
> > > we
> > > > > > push Apache Geode 1.1?
> > > > >
> > > > >
> > > >
> > >
> >
>

Re: Hosted API docs update?

[Dave Barnes]

Thanks, Mark. So Sai, you should see your updates in the 1.1.0-snapshot API
docs.
It has been pointed out to me that the 'incubating' API docs are, in fact,
current for 1.0.0, as the build occurred prior to graduation.


On Fri, Jan 13, 2017 at 2:09 PM, Mark Bretl  wrote:

> Latest development javadocs built with the nightly build and are available
> at
> https://builds.apache.org/view/G/view/Geode/job/Geode-
> nightly/lastSuccessfulBuild/artifact/geode-assembly/build/
> install/apache-geode/javadoc/
>
> --Mark
>
> On Fri, Jan 13, 2017 at 11:31 AM, Dave Barnes  wrote:
>
> > @Anthony Thanks for the pointer, but I guess I need a little more detail.
> > When I look at the javadocs in my Geode source repo, I find a set at
> > geode-assembly/build/javadocs that's labeled 1.1.0-SNAPSHOT.
> > I went to the Geode website Releases page to download the binary
> > distribution (http://geode.apache.org/releases/). It offers v
> > 1.0.0-incubating.
> >
> >
> >
> > On Fri, Jan 13, 2017 at 11:01 AM, Sai Boorlagadda <
> > sai.boorlaga...@gmail.com
> > > wrote:
> >
> > > +1 to link API docs to release page.
> > >
> > > On Fri, Jan 13, 2017 at 10:42 AM, Anthony Baker 
> > wrote:
> > >
> > > > +1
> > > >
> > > > I’d would like to link the docs + javadocs from the release page,
> > similar
> > > > to what we do for the release archives.
> > > >
> > > > Anthony
> > > >
> > > >
> > > > > On Jan 13, 2017, at 10:39 AM, Joey McAllister <
> > jmcallis...@pivotal.io>
> > > > wrote:
> > > > >
> > > > > Do we also want to archive the API
> > > > > documentation, so the Apache Geode 1.0 APIs are still available
> when
> > we
> > > > > push Apache Geode 1.1?
> > > >
> > > >
> > >
> >
>

Re: Hosted API docs update?

[Mark Bretl]

Latest development javadocs built with the nightly build and are available
at
https://builds.apache.org/view/G/view/Geode/job/Geode-nightly/lastSuccessfulBuild/artifact/geode-assembly/build/install/apache-geode/javadoc/

--Mark

On Fri, Jan 13, 2017 at 11:31 AM, Dave Barnes  wrote:

> @Anthony Thanks for the pointer, but I guess I need a little more detail.
> When I look at the javadocs in my Geode source repo, I find a set at
> geode-assembly/build/javadocs that's labeled 1.1.0-SNAPSHOT.
> I went to the Geode website Releases page to download the binary
> distribution (http://geode.apache.org/releases/). It offers v
> 1.0.0-incubating.
>
>
>
> On Fri, Jan 13, 2017 at 11:01 AM, Sai Boorlagadda <
> sai.boorlaga...@gmail.com
> > wrote:
>
> > +1 to link API docs to release page.
> >
> > On Fri, Jan 13, 2017 at 10:42 AM, Anthony Baker 
> wrote:
> >
> > > +1
> > >
> > > I’d would like to link the docs + javadocs from the release page,
> similar
> > > to what we do for the release archives.
> > >
> > > Anthony
> > >
> > >
> > > > On Jan 13, 2017, at 10:39 AM, Joey McAllister <
> jmcallis...@pivotal.io>
> > > wrote:
> > > >
> > > > Do we also want to archive the API
> > > > documentation, so the Apache Geode 1.0 APIs are still available when
> we
> > > > push Apache Geode 1.1?
> > >
> > >
> >
>

Re: Hosted API docs update?

[Dave Barnes]

@Anthony Thanks for the pointer, but I guess I need a little more detail.
When I look at the javadocs in my Geode source repo, I find a set at
geode-assembly/build/javadocs that's labeled 1.1.0-SNAPSHOT.
I went to the Geode website Releases page to download the binary
distribution (http://geode.apache.org/releases/). It offers v
1.0.0-incubating.



On Fri, Jan 13, 2017 at 11:01 AM, Sai Boorlagadda  wrote:

> +1 to link API docs to release page.
>
> On Fri, Jan 13, 2017 at 10:42 AM, Anthony Baker  wrote:
>
> > +1
> >
> > I’d would like to link the docs + javadocs from the release page, similar
> > to what we do for the release archives.
> >
> > Anthony
> >
> >
> > > On Jan 13, 2017, at 10:39 AM, Joey McAllister 
> > wrote:
> > >
> > > Do we also want to archive the API
> > > documentation, so the Apache Geode 1.0 APIs are still available when we
> > > push Apache Geode 1.1?
> >
> >
>

Re: Hosted API docs update?

[Sai Boorlagadda]

+1 to link API docs to release page.

On Fri, Jan 13, 2017 at 10:42 AM, Anthony Baker  wrote:

> +1
>
> I’d would like to link the docs + javadocs from the release page, similar
> to what we do for the release archives.
>
> Anthony
>
>
> > On Jan 13, 2017, at 10:39 AM, Joey McAllister 
> wrote:
> >
> > Do we also want to archive the API
> > documentation, so the Apache Geode 1.0 APIs are still available when we
> > push Apache Geode 1.1?
>
>

Re: Hosted API docs update?

[Anthony Baker]

+1

I’d would like to link the docs + javadocs from the release page, similar to 
what we do for the release archives.

Anthony


> On Jan 13, 2017, at 10:39 AM, Joey McAllister  wrote:
> 
> Do we also want to archive the API
> documentation, so the Apache Geode 1.0 APIs are still available when we
> push Apache Geode 1.1?

Re: Hosted API docs update?

[Anthony Baker]

I think the javadocs available on geode.apache.org should reflect a specific 
release (currently 1.0.0-incubating).

@Dave, the build does generate a complete javadoc set.  It’s located in the 
binary distribution in the javadoc/ directory.

Anthony

> On Jan 13, 2017, at 10:29 AM, Dave Barnes  wrote:
> 
> My message crossed paths with Swapnil's. I think what Sai noticed was that
> the title of the API docs still says "incubating", which I find to be true
> of the "latest" release to which Swap points. So I think there's still a
> need for a freshly-generated set of Javadocs.
> 
> 
> On Fri, Jan 13, 2017 at 10:25 AM, Dave Barnes  wrote:
> 
>> Hi Sai,
>> I filed a JIRA ticket on this a couple of weeks ago: GEODE-2264.
>> First obstacle I encountered was that the Gradle builds that update
>> Javadocs do so component-by-component, so task number 1 would be to create
>> a single Geode-wide Javadoc tree. Once that's in place, it's just a matter
>> of updating the website. (The website procedure is in the midst of a change
>> - Joey McAllister has a PR pending on the subject.)
>> -Dave
>> 
>> On Fri, Jan 13, 2017 at 10:05 AM, Sai Boorlagadda <
>> sai.boorlaga...@gmail.com> wrote:
>> 
>>> Any pointers on how to update hosted API documentation?
>>> http://geode.apache.org/releases/latest/javadoc/index.html
>>> 
>>> Sai
>>> 
>> 
>> 

Re: Hosted API docs update?

[Joey McAllister]

My pull request  (for GEODE-2031) changes the Docs page to include more
than just the most recent release of the User Guide (e.g., when we release
Apache Geode 1.1., the User Guide for Apache Geode 1.0 will still be
available from the Docs page). Do we also want to archive the API
documentation, so the Apache Geode 1.0 APIs are still available when we
push Apache Geode 1.1?

On Fri, Jan 13, 2017 at 10:30 AM Dave Barnes  wrote:

My message crossed paths with Swapnil's. I think what Sai noticed was that
the title of the API docs still says "incubating", which I find to be true
of the "latest" release to which Swap points. So I think there's still a
need for a freshly-generated set of Javadocs.


On Fri, Jan 13, 2017 at 10:25 AM, Dave Barnes  wrote:

> Hi Sai,
> I filed a JIRA ticket on this a couple of weeks ago: GEODE-2264.
> First obstacle I encountered was that the Gradle builds that update
> Javadocs do so component-by-component, so task number 1 would be to create
> a single Geode-wide Javadoc tree. Once that's in place, it's just a matter
> of updating the website. (The website procedure is in the midst of a
change
> - Joey McAllister has a PR pending on the subject.)
> -Dave
>
> On Fri, Jan 13, 2017 at 10:05 AM, Sai Boorlagadda <
> sai.boorlaga...@gmail.com> wrote:
>
>> Any pointers on how to update hosted API documentation?
>> http://geode.apache.org/releases/latest/javadoc/index.html
>>
>> Sai
>>
>
>

Re: Hosted API docs update?

[Sai Boorlagadda]

With a recent commit to fix https://issues.apache.org/jira/browse/GEODE-523
I had to change javadocs on Interface "PartitionListener".

I dont see the API docs being update automatically, so wasn't sure whats
the process to roll the changes into hosted API docs.

On Fri, Jan 13, 2017 at 10:23 AM, Swapnil Bawaskar 
wrote:

> Hi Sai,
> The javadocs are in the asf-site branch:
> https://github.com/apache/geode/tree/asf-site/releases The most current
> javadocs live the "latest" folder.
>
> I saw that the hosted javadocs are upto data already. Are we missing
> anything?
>
> On Fri, Jan 13, 2017 at 10:05 AM, Sai Boorlagadda <
> sai.boorlaga...@gmail.com
> > wrote:
>
> > Any pointers on how to update hosted API documentation?
> > http://geode.apache.org/releases/latest/javadoc/index.html
> >
> > Sai
> >
>

Re: Hosted API docs update?

[Dave Barnes]

My message crossed paths with Swapnil's. I think what Sai noticed was that
the title of the API docs still says "incubating", which I find to be true
of the "latest" release to which Swap points. So I think there's still a
need for a freshly-generated set of Javadocs.


On Fri, Jan 13, 2017 at 10:25 AM, Dave Barnes  wrote:

> Hi Sai,
> I filed a JIRA ticket on this a couple of weeks ago: GEODE-2264.
> First obstacle I encountered was that the Gradle builds that update
> Javadocs do so component-by-component, so task number 1 would be to create
> a single Geode-wide Javadoc tree. Once that's in place, it's just a matter
> of updating the website. (The website procedure is in the midst of a change
> - Joey McAllister has a PR pending on the subject.)
> -Dave
>
> On Fri, Jan 13, 2017 at 10:05 AM, Sai Boorlagadda <
> sai.boorlaga...@gmail.com> wrote:
>
>> Any pointers on how to update hosted API documentation?
>> http://geode.apache.org/releases/latest/javadoc/index.html
>>
>> Sai
>>
>
>

Re: Hosted API docs update?

[Dave Barnes]

Hi Sai,
I filed a JIRA ticket on this a couple of weeks ago: GEODE-2264.
First obstacle I encountered was that the Gradle builds that update
Javadocs do so component-by-component, so task number 1 would be to create
a single Geode-wide Javadoc tree. Once that's in place, it's just a matter
of updating the website. (The website procedure is in the midst of a change
- Joey McAllister has a PR pending on the subject.)
-Dave

On Fri, Jan 13, 2017 at 10:05 AM, Sai Boorlagadda  wrote:

> Any pointers on how to update hosted API documentation?
> http://geode.apache.org/releases/latest/javadoc/index.html
>
> Sai
>

Re: Hosted API docs update?

[Swapnil Bawaskar]

Hi Sai,
The javadocs are in the asf-site branch:
https://github.com/apache/geode/tree/asf-site/releases The most current
javadocs live the "latest" folder.

I saw that the hosted javadocs are upto data already. Are we missing
anything?

On Fri, Jan 13, 2017 at 10:05 AM, Sai Boorlagadda  wrote:

> Any pointers on how to update hosted API documentation?
> http://geode.apache.org/releases/latest/javadoc/index.html
>
> Sai
>

Hosted API docs update?

[Sai Boorlagadda]

Any pointers on how to update hosted API documentation?
http://geode.apache.org/releases/latest/javadoc/index.html

Sai