Re: Doc comments on unsupported versions

From: "Jonathan S(dot) Katz" <jkatz(at)postgresql(dot)org>
To: Magnus Hagander <magnus(at)hagander(dot)net>
Cc: Daniel Gustafsson <daniel(at)yesql(dot)se>, PostgreSQL www <pgsql-www(at)postgresql(dot)org>
Subject: Re: Doc comments on unsupported versions
Date: 2018-02-19 02:51:09
Message-ID: E9C00FCA-115D-45E7-A5F1-4E965B5CB324@postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-www


> On Feb 17, 2018, at 1:35 PM, Magnus Hagander <magnus(at)hagander(dot)net> wrote:
>
> On Fri, Feb 16, 2018 at 10:02 PM, Daniel Gustafsson <daniel(at)yesql(dot)se <mailto:daniel(at)yesql(dot)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

In response to

Responses

Browse pgsql-www by date

  From Date Subject
Next Message Jonathan S. Katz 2018-02-19 02:52:38 Re: Doc comments on unsupported versions
Previous Message Peter Eisentraut 2018-02-18 22:42:12 Re: Doc comments on unsupported versions