Re: Doc comments on unsupported versions

From: David Fetter <david(at)fetter(dot)org>
To: Magnus Hagander <magnus(at)hagander(dot)net>
Cc: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, "Jonathan S(dot) Katz" <jkatz(at)postgresql(dot)org>, Daniel Gustafsson <daniel(at)yesql(dot)se>, PostgreSQL www <pgsql-www(at)postgresql(dot)org>
Subject: Re: Doc comments on unsupported versions
Date: 2018-05-08 14:45:03
Message-ID: 20180508144502.GA6876@fetter.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-www

On Thu, May 03, 2018 at 07:38:43PM +0200, Magnus Hagander wrote:
> On Thu, May 3, 2018 at 4:08 PM, Peter Eisentraut <
> peter(dot)eisentraut(at)2ndquadrant(dot)com> wrote:
>
> - Disable the link for submitting documentation comments on EOL versions.
>
> I actually thought we had done that, but it seems not. That should be an
> easy enough fix.

Excellent plan!

> - Enforce a minimum number of characters in comments (hello Stack Overflow).
>
> Do you have a suggested number? :)

5000 would cut down on the silliness pretty completely. 250 would do
the same, but be less obviously obnoxious.

> > I would even go so far as
> >
> > - Remove EOL documentation for search engine results.
>
> We do include them, but we drop their priority to the lowest possible one.
> Supposedly that should mean you can only get to them if you explicitly
> choose which version to include, but it appears search engines really don't
> give a shit about that.
>
> We have previously said we don't want to remove them completely, because
> that makes it impossible to search for historical data. But we've also said
> that maybe we have to give up, because search engines don't even let us
> de-prioritize our own pages :(

I think that by the time someone is searching for things PostgreSQL
8.2, that's specialty enough a request that they should come to
postgresql.org and do it rather than relying on someone else's search
engine.

> > - Display them in faint grey text color or otherwise make them annoying
> > to read.
>
> Unfortunately, the <blink> tag has been removed from browsers..

Fortunately, there are more modern ways to be super annoying. For
example: https://codepen.io/anasandoval90/pen/jPXxaR

Best,
David.
--
David Fetter <david(at)fetter(dot)org> http://fetter.org/
Phone: +1 415 235 3778

Remember to vote!
Consider donating to Postgres: http://www.postgresql.org/about/donate

In response to

Responses

Browse pgsql-www by date

  From Date Subject
Next Message Craig Ringer 2018-05-08 23:48:12 Re: Doc comments on unsupported versions
Previous Message Jonathan S. Katz 2018-05-05 18:05:49 Re: [patch] Add Ubuntu bionic