Re: Doc comments on unsupported versions

Поиск
Список
Период
Сортировка
От Jonathan S. Katz
Тема Re: Doc comments on unsupported versions
Дата
Msg-id E9C00FCA-115D-45E7-A5F1-4E965B5CB324@postgresql.org
обсуждение исходный текст
Ответ на Re: Doc comments on unsupported versions  (Magnus Hagander <magnus@hagander.net>)
Ответы Re: Doc comments on unsupported versions
Список pgsql-www

On Feb 17, 2018, at 1:35 PM, Magnus Hagander <magnus@hagander.net> wrote:

On Fri, Feb 16, 2018 at 10:02 PM, Daniel Gustafsson <daniel@yesql.se> wrote:
The doc comment form is linked from all doc pages, and while most submissions
are from supported versions there are sometimes reports coming in from old
versions.  Since fixes aren’t applied to unsupported versions, and many reports
against old version have been fixed already, only allowing comments on
supported versions seems reasonable.  The attached (untested) patch implements
a proposal for this.

Is something like this of interest, or are we putting enough value on the
comments on unsupported versions that we want to keep them?

I think yes, let's drop it for unsupported versions. The more we can make it clear to people that they're unsupported, the better. 

Just to argue the other side, just because the versions are unsupported
does not mean that people are not using those versions and at scale.
If there is something that is erroneous in the documentation, it would
not hurt to fix it, and there is a chance it is incorrect in a supported version.

With that said, it is understandably additional administrative overhead on
our end and it just limiting doc comments to supported versions (and possibly
devel?) would limit our focus on just keeping the supported docs up to date.

I’m fine with dropping the support for this on unsupported versions. If
there is something seriously incorrect with those documents that require updating,
there are other ways to reach out.

Jonathan

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

Предыдущее
От: Peter Eisentraut
Дата:
Сообщение: Re: Doc comments on unsupported versions
Следующее
От: "Jonathan S. Katz"
Дата:
Сообщение: Re: Doc comments on unsupported versions