From: | Magnus Hagander <magnus(at)hagander(dot)net> |
---|---|
To: | Thom Brown <thombrown(at)gmail(dot)com> |
Cc: | Stefan Kaltenbrunner <stefan(at)kaltenbrunner(dot)cc>, Cédric Villemain <cedric(dot)villemain(dot)debian(at)gmail(dot)com>, Rob Wultsch <wultsch(at)gmail(dot)com>, pgsql-www <pgsql-www(at)postgresql(dot)org> |
Subject: | Re: Links to previous and future versions of documentation |
Date: | 2010-05-18 15:30:50 |
Message-ID: | AANLkTimPnGH-KtXy78xdRlYF1jH5DErUnSGYWAnzPS3a@mail.gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-www |
On Tue, May 18, 2010 at 5:16 PM, Thom Brown <thombrown(at)gmail(dot)com> wrote:
> On 18 May 2010 14:31, Stefan Kaltenbrunner <stefan(at)kaltenbrunner(dot)cc> wrote:
>> On 05/17/2010 10:21 AM, Cédric Villemain wrote:
>>> 2010/5/17 Rob Wultsch <wultsch(at)gmail(dot)com>:
>>>> Howdy all,
>>>> I am a MySQL DBA and very much like how the web based MySQL
>>>> documentation links to previous and future versions of the same page.
>>>> As an example on the documentation on the INSERT command for 5.1
>>>> (http://dev.mysql.com/doc/refman/5.1/en/insert.html) there are link on
>>>> the left hand side to the same document for version the 3.23/4.0/4.1,
>>>> 5.0. 5.4, and 5.5.
>>>>
>>>> I find the lack of this feature on the Postgres web site slightly
>>>> annoying and would be willing to help implement it. I was thinking
>>>> that it could fit in well with the breadcrumbs at the top.
>>>>
>>>> Any thoughts?
>>>
>>> linking between docs of each stable versions like proposed seems
>>> interesting for me.
>>
>> what would you do for stuff that is completely rearranged or
>> removed/added in newer/older versions?
>
> Yes, plus not to mention all the extra overhead that would go into
> maintaining the links when new releases are being produced. It seems
> like a lot of work just to compare versions. Plus I much prefer
> PostgreSQL's clean and uncluttered documentation. I rarely need to
> compare versions, and really, if I ever wanted to, I'd change the URL:
We can easily auto-generate links *if the filename stays the same*. It
often doesn't. As an example, 9.0 has 32 pages that don't exist in
8.4, and 8.4 has 9 pages that don't exist in 9.0. The same comparison
earlier shows for example that 8.0 has 10 pages that aren't in 8.1,
and 8.1 has 74 pages that aren't in 8.0.
Some of those are the releasenote pages for point-releases, of course.
The relevant there might be that of the 9 pages in 8.4 that aren't in
9.0, 6 are actually point-releases that show up since we haven't
released 9.0beta2 yet. But release notes could of course be excluded.
It would be easy to have the site add links if the match is exact. If
it's not, I definitely don't want to get into the heuristics business.
--
Magnus Hagander
Me: http://www.hagander.net/
Work: http://www.redpill-linpro.com/
From | Date | Subject | |
---|---|---|---|
Next Message | Alvaro Herrera | 2010-05-18 15:40:42 | Re: Links to previous and future versions of documentation |
Previous Message | Thom Brown | 2010-05-18 15:16:33 | Re: Links to previous and future versions of documentation |