Re: Documentation: references to old versions - Mailing list pgsql-hackers

From Magnus Hagander
Subject Re: Documentation: references to old versions
Date
Msg-id CABUevExXPJxdKiV+VwN2VTi7YP6qX6uMo-xb12a6=jduJeYbjA@mail.gmail.com
Whole thread Raw
In response to Re: Documentation: references to old versions  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-hackers
On Tue, Feb 12, 2013 at 4:22 PM, Tom Lane <tgl@sss.pgh.pa.us> wrote:
> Magnus Hagander <magnus@hagander.net> writes:
>> On Tue, Feb 12, 2013 at 10:19 AM, Dave Page <dpage@pgadmin.org> wrote:
>>> The phrasing "as of 8.2" basically means "from 8.2 onwards". Changing the
>>> version there would make the text incorrect.
>
>> In theory we could remove that reference completely since any versions
>> where it does not apply are out of support since years ago at this
>> point. But I don't see a point in doing that just for the sake of
>> removing - but if a section is reworded in general that contains such
>> references, it could be dropped.
>
> The fact that pre-8.2 is out of support doesn't make this useless
> information: many such installations are still out there in the wild,
> and people may want to know what techniques will work with them.
> I'd be inclined to leave the text as-is until it's been awhile since
> we've heard of anyone using pre-8.2.

If you are using an earlier version, you should really be reading the
documentation that corresponds to the version that you are using.

That said, this general reason is why I say we shouldn't go remove it
intentionally. I'm just saying it's acceptable "collateral damage" if
it gets removed along with another patch, and that we shouldn't put
special efforts into maintaining it.

I'd rather see that special effort go into encouraging people to read
the version of the documentation that matches their version of
PostgreSQL...

-- Magnus HaganderMe: http://www.hagander.net/Work: http://www.redpill-linpro.com/



pgsql-hackers by date:

Previous
From: Satoshi Nagayasu
Date:
Subject: [RFC] pgstattuple/pgstatindex enhancement
Next
From: Andres Freund
Date:
Subject: Re: Re: Proposal for Allow postgresql.conf values to be changed via SQL [review]