Re: Adding since-version tags to the docs?

Поиск
Список
Период
Сортировка
От Tom Lane
Тема Re: Adding since-version tags to the docs?
Дата
Msg-id 6267.1441032481@sss.pgh.pa.us
обсуждение исходный текст
Ответ на Re: Adding since-version tags to the docs?  ("Shulgin, Oleksandr" <oleksandr.shulgin@zalando.de>)
Ответы Re: Adding since-version tags to the docs?  (Andres Freund <andres@anarazel.de>)
Re: Adding since-version tags to the docs?  (Catalin Iacob <iacobcatalin@gmail.com>)
Список pgsql-hackers
"Shulgin, Oleksandr" <oleksandr.shulgin@zalando.de> writes:
> On Mon, Aug 31, 2015 at 4:01 PM, Tom Lane <tgl@sss.pgh.pa.us> wrote:
>> TBH, I think this is a horrid idea.  We occasionally manually add remarks
>> like "since version x.y, Postgres does this".  Inevitably, that just bulks
>> up the documentation; and it starts to look seriously silly in a few years
>> when x.y and all its predecessors are out of support.

> Well, I wouldn't name it outright silly: what's so bad about knowing that
> certain feature was there since 9.0, for example?

Right now, you might well care about whether a feature arrived in 9.3 vs
9.4, for instance; but it's highly unlikely that you care whether a
feature arrived in 7.1 or 7.2.  The problem with this proposal is that
it will add far more bloat of the latter sort than currently-useful
information; and the ratio will get worse over time.
        regards, tom lane



В списке pgsql-hackers по дате отправления:

Предыдущее
От: Tom Lane
Дата:
Сообщение: Re: Better detection of staled postmaster.pid
Следующее
От: "David G. Johnston"
Дата:
Сообщение: Re: Adding since-version tags to the docs?