Re: Geode Website Docs page: Proposal to limit the number of versions listed.

2018-02-02 Thread Dave Barnes
Based on comments received, no changes for Geode 1.4.

On Wed, Jan 31, 2018 at 11:05 AM, Sai Boorlagadda  wrote:

> Adding user@geode.apache.org to the email thread to see if any users has
> inputs.
> I'm fine showing only one version of Java docs, as a developer I access
> the Java docs in my IDE based on which ever version I am using to build
> geode application.
>
> Sai
>
> On Wed, Jan 31, 2018 at 10:23 AM, Dave Barnes  wrote:
>
>> I'm hearing that access to earlier versions of the User Guide is important
>> to some folks.
>> Everyone OK with only one version of the Javadocs, as is the current
>> practice?
>>
>>
>> On Mon, Jan 29, 2018 at 11:12 AM, Alexander Murmann 
>> wrote:
>>
>> > Maybe we could have a link at the bottom that goes to a full list?
>> >
>> > On Mon, Jan 29, 2018 at 11:10 AM, Michael William Dodge <
>> mdo...@pivotal.io
>> > >
>> > wrote:
>> >
>> > > I'm fine with the proposal. It would be nice if there was a way to
>> > > navigate to user documentation for older versions; perhaps just rely
>> on
>> > > Google? ;)
>> > >
>> > > Sarge
>> > >
>> > > > On 29 Jan, 2018, at 10:39, Dave Barnes  wrote:
>> > > >
>> > > > Question:
>> > > > How many versions of the User Documentation and the Javadocs do we
>> need
>> > > to
>> > > > see on the Geode Docs page (http://geode.apache.org/docs)?
>> > > >
>> > > > The current scheme has two policies:
>> > > > - For the User Documentation, there's a link for each of four
>> versions:
>> > > > 1.0, 1.1, 1.2 and 1.3. There will soon be a fifth bullet for v1.4.
>> > > > - For the Javadocs, there's only one link which points to the latest
>> > > > version, currently 1.3. Users who need earlier versions can
>> presumably
>> > > find
>> > > > them among their own copies of the source code.
>> > > >
>> > > > Proposal:
>> > > > - Shorten the list for the User Documentation, showing only the
>> three
>> > > most
>> > > > recent versions
>> > > > - No change for the Javadocs, link to only the most recent version
>> > > >
>> > > > What do you think?
>> > >
>> > >
>> >
>>
>
>


Re: Geode Website Docs page: Proposal to limit the number of versions listed.

2018-01-31 Thread Sai Boorlagadda
Adding user@geode.apache.org to the email thread to see if any users has
inputs.
I'm fine showing only one version of Java docs, as a developer I access the
Java docs in my IDE based on which ever version I am using to build geode
application.

Sai

On Wed, Jan 31, 2018 at 10:23 AM, Dave Barnes  wrote:

> I'm hearing that access to earlier versions of the User Guide is important
> to some folks.
> Everyone OK with only one version of the Javadocs, as is the current
> practice?
>
>
> On Mon, Jan 29, 2018 at 11:12 AM, Alexander Murmann 
> wrote:
>
> > Maybe we could have a link at the bottom that goes to a full list?
> >
> > On Mon, Jan 29, 2018 at 11:10 AM, Michael William Dodge <
> mdo...@pivotal.io
> > >
> > wrote:
> >
> > > I'm fine with the proposal. It would be nice if there was a way to
> > > navigate to user documentation for older versions; perhaps just rely on
> > > Google? ;)
> > >
> > > Sarge
> > >
> > > > On 29 Jan, 2018, at 10:39, Dave Barnes  wrote:
> > > >
> > > > Question:
> > > > How many versions of the User Documentation and the Javadocs do we
> need
> > > to
> > > > see on the Geode Docs page (http://geode.apache.org/docs)?
> > > >
> > > > The current scheme has two policies:
> > > > - For the User Documentation, there's a link for each of four
> versions:
> > > > 1.0, 1.1, 1.2 and 1.3. There will soon be a fifth bullet for v1.4.
> > > > - For the Javadocs, there's only one link which points to the latest
> > > > version, currently 1.3. Users who need earlier versions can
> presumably
> > > find
> > > > them among their own copies of the source code.
> > > >
> > > > Proposal:
> > > > - Shorten the list for the User Documentation, showing only the three
> > > most
> > > > recent versions
> > > > - No change for the Javadocs, link to only the most recent version
> > > >
> > > > What do you think?
> > >
> > >
> >
>