Mailing-List: contact dev-help@cordova.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@cordova.apache.org
Received-SPF: pass (athena.apache.org: domain of mikeywbrooks@gmail.com
 designates 74.125.82.173 as permitted sender)
MIME-Version: 1.0
Sender: mikeywbrooks@gmail.com
In-Reply-To: <DCF4E2A8-4F89-465B-8CE9-C8F3D848F0D1@dataclysm.com>
References: <DCF4E2A8-4F89-465B-8CE9-C8F3D848F0D1@dataclysm.com>
Date: Mon, 4 Mar 2013 15:40:09 -0800
Message-ID: 
 <CAP7NMPry-Pd0bGneXUhCG6JLGnwo15gTewzVzMgxQoJmrr_5xg@mail.gmail.com>
Subject: Re: Cordova Documentation version based urls make for poor web search
 targets
From: Michael Brooks <michael@michaelbrooks.ca>
To: dev@cordova.apache.org
Content-Type: multipart/alternative; boundary=f46d044283489ffa1204d721e0c7

--f46d044283489ffa1204d721e0c7
Content-Type: text/plain; charset=ISO-8859-1

>
>  When I google for cordova documentation, I'm usually taken to an old version
> (say, 2.1.0).


This has also been a problem with the PhoneGap documentation.

Eventually, the doc generator will be rewritten and we should definitely
keep this issue in mind.

It would be nice to have a short-term solution though. I like the idea of
adding some JavaScript inspection and rendering a small flash message at
the top. I'll create a JIRA issue for this.

Also, I took a look at how some other projects do it (like python) and they
> just use a single url for "latest" and only create custom version-based
> urls for previous releases.  (And since they link to latest more often than
> to specific releases, I guess it naturally ranks higher)


Yup, I think the "latest" directory or storing the latest release in the
root directory should be a long-term solution for the rewritten generator.

The documentation URL in the MIDDLE of cordova.apache.org still points to
> the 2.4.0 docs.  The one on the bottom correctly points to 2.5.0. Couldn't
> all links just point to the LATEST version of the docs and have the server
> just handle the redirection via symlink?


I noticed this as well and updated the generator. That documentation link
is now generated from the latest release version, so there is no need to
manually update it.

On Fri, Mar 1, 2013 at 10:26 AM, Marc Fielding
<marc.fielding@dataclysm.com>wrote:

> To follow on to this point:
>
> The documentation URL in the MIDDLE of cordova.apache.org still points to
> the 2.4.0 docs.  The one on the bottom correctly points to 2.5.0. Couldn't
> all links just point to the LATEST version of the docs and have the server
> just handle the redirection via symlink?
>
> Thanks,
>
> Marc

--f46d044283489ffa1204d721e0c7--