Re: Doc comments on unsupported versions - Mailing list pgsql-www

From Jonathan S. Katz
Subject Re: Doc comments on unsupported versions
Date
Msg-id E9C00FCA-115D-45E7-A5F1-4E965B5CB324@postgresql.org
Whole thread Raw
In response to Re: Doc comments on unsupported versions  (Magnus Hagander <magnus@hagander.net>)
Responses Re: Doc comments on unsupported versions
List 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 by date:

Previous
From: Peter Eisentraut
Date:
Subject: Re: Doc comments on unsupported versions
Next
From: "Jonathan S. Katz"
Date:
Subject: Re: Doc comments on unsupported versions