Re: Viewing old versions of docs

2015-10-02 Thread Benjamin Mahler
We'd like to provide versioned docs on the website, as follows:

http://mesos.apache.org/documentation/latest/
http://mesos.apache.org/documentation/0.24.0/
http://mesos.apache.org/documentation/0.23.0/
etc.

This is why "latest" was put into the link format.

On Fri, Oct 2, 2015 at 2:29 PM, Alan Braithwaite 
wrote:

> Thanks Joseph.
>
> To your point of not reading older versions of the docs though: that's
> pretty silly.  You must realize how quickly the project is moving and as
> such there's no sense in being mislead about the feature set of the version
> which you're using.
>
> In my case I was looking through the docs to find the new 0.24 API which
> doesn't exist on the version I'm currently using: 0.23. :-|
>
> Also, as a user if I see /latest/ in the url, I'm going to assume that the
> older versions are hosted online as well.  Maybe I'm just weird though. :-)
>
> Thanks for the pointers,
> - Alan
>
> On Fri, Oct 2, 2015 at 11:34 AM, Joseph Wu  wrote:
>
>> Hi Alan,
>>
>> I don't think it's recommended to refer to older versions of the docs.
>> But if you absolutely need to, you can find those by browsing the source.
>>
>> Take the version of Mesos you're looking for, and substitute it for
>> "" below:
>> https://github.com/apache/mesos/blob//docs/
>>
>> i.e. For the most recent release:
>> https://github.com/apache/mesos/blob/0.24.1/docs/
>>
>> ~Joseph
>>
>> On Fri, Oct 2, 2015 at 11:02 AM, Alan Braithwaite 
>> wrote:
>>
>>> Hey All,
>>>
>>> Trying to figure out how to view older versions of the docs on the web.
>>> Can't find an index or link to versioned docs from google.
>>>
>>> Can anyone point me in the right direction?
>>>
>>> Thanks,
>>> - Alan
>>>
>>
>>
>


Re: Viewing old versions of docs

2015-10-02 Thread Alan Braithwaite
Thanks Joseph.

To your point of not reading older versions of the docs though: that's
pretty silly.  You must realize how quickly the project is moving and as
such there's no sense in being mislead about the feature set of the version
which you're using.

In my case I was looking through the docs to find the new 0.24 API which
doesn't exist on the version I'm currently using: 0.23. :-|

Also, as a user if I see /latest/ in the url, I'm going to assume that the
older versions are hosted online as well.  Maybe I'm just weird though. :-)

Thanks for the pointers,
- Alan

On Fri, Oct 2, 2015 at 11:34 AM, Joseph Wu  wrote:

> Hi Alan,
>
> I don't think it's recommended to refer to older versions of the docs.
> But if you absolutely need to, you can find those by browsing the source.
>
> Take the version of Mesos you're looking for, and substitute it for
> "" below:
> https://github.com/apache/mesos/blob//docs/
>
> i.e. For the most recent release:
> https://github.com/apache/mesos/blob/0.24.1/docs/
>
> ~Joseph
>
> On Fri, Oct 2, 2015 at 11:02 AM, Alan Braithwaite 
> wrote:
>
>> Hey All,
>>
>> Trying to figure out how to view older versions of the docs on the web.
>> Can't find an index or link to versioned docs from google.
>>
>> Can anyone point me in the right direction?
>>
>> Thanks,
>> - Alan
>>
>
>


Re: Viewing old versions of docs

2015-10-02 Thread Joseph Wu
Hi Alan,

I don't think it's recommended to refer to older versions of the docs.  But
if you absolutely need to, you can find those by browsing the source.

Take the version of Mesos you're looking for, and substitute it for
"" below:
https://github.com/apache/mesos/blob//docs/

i.e. For the most recent release:
https://github.com/apache/mesos/blob/0.24.1/docs/

~Joseph

On Fri, Oct 2, 2015 at 11:02 AM, Alan Braithwaite 
wrote:

> Hey All,
>
> Trying to figure out how to view older versions of the docs on the web.
> Can't find an index or link to versioned docs from google.
>
> Can anyone point me in the right direction?
>
> Thanks,
> - Alan
>


Viewing old versions of docs

2015-10-02 Thread Alan Braithwaite
Hey All,

Trying to figure out how to view older versions of the docs on the web.
Can't find an index or link to versioned docs from google.

Can anyone point me in the right direction?

Thanks,
- Alan