Re: Links for upgraders

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Peter Eisentraut <peter_e(at)gmx(dot)net>
Cc: Vik Fearing <vik(dot)fearing(at)dalibo(dot)com>, PG Docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Links for upgraders
Date: 2014-02-12 23:40:25
Message-ID: 2469.1392248425@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Peter Eisentraut <peter_e(at)gmx(dot)net> writes:
> I think it would be even better to link directly to the migration notes,
> not to the top-level section of the release notes. I suggest to add a
> link target like

> <sect2 id="release-9-2-4-migration">
> <title>Migration to Version 9.2.4</title>

> and then link to that.

I experimented with this and didn't really find that it improved the
browsing experience any compared to what Vik did. It might be noticeably
better if we had any significant amount of text above the "migration"
section, but we never do.

I'd prefer *not* to add yet another place where the version number
has to be manually adjusted each time one makes a new release-notes
section. (This is a task we've failed at a few times in the past ;-),
so I'm not just hypothecating.) So I'm -1 for this unless there's
really, really strong contrary opinion.

regards, tom lane

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Joshua D. Drake 2014-02-13 00:04:42 Re: Links for upgraders
Previous Message Tom Lane 2014-02-12 23:18:35 Re: [HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)