Re: Adding since-version tags to the docs?

On Mon, Aug 31, 2015 at 4:48 PM, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
> 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.

After working with Python, when reading the Postgres docs I did feel
this was missing so +1 from a user. An example for Python's
annotations is at https://docs.python.org/3/library/zipfile.html.
Python only keeps the annotations for a few versions back (3 or 4 I
think).

Another use case which is maybe worth mentioning explicitly: when I
needed to target a certain older version of Python, as long as it was
reasonably close to the current one, I would still read the latest
Python docs and rely on the version annotations to let me know I can't
yet use certain features. For Postgres, that doesn't feel "safe" so
you tend to go to the docs of the specific version you're targeting.
But by doing that, you miss getting extra education about improvements
in newer versions. That extra information could also be a powerful
trigger to update in order to gain those improvements. I think both
are quite valuable.