From: rasmus@mindplay.dk
To: pgsql-docs@postgresql.org
Subject: Useful documentation removed from 9.5 docs
Date: Tue, 22 Aug 2017 07:27:54 +0000
Message-ID: <20170822072754.1454.68800@wrigleys.postgresql.org> (raw)
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-docs>
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/9.5/static/textsearch-indexes.html
Description:
I was looking for the section that provides advice on which type of index
(GIN vs GIST) to choose, and discovered that it has been removed from the
9.5/9.6 documentation.
Here's the 9.4 version:
https://www.postgresql.org/docs/9.4/static/textsearch-indexes.html
Compare with the 9.5 version:
https://www.postgresql.org/docs/9.5/static/textsearch-indexes.html
The whole section of bullet-points describing considerations for choosing
the index type were removed.
Instead, this manual page now talks mostly about implementation details,
internal details about how the GIST index internally operates, and on -
these may be relevant to somebody, but they're likely not very useful to
the average user trying to select the appropriate index for a given
use-case.
I'm puzzled as to why this information was removed. One has to find the 9.4
version of the page via Google, or an article on StackOverflow, to get this
useful information.
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: rasmus@mindplay.dk
Subject: Re: Useful documentation removed from 9.5 docs
In-Reply-To: <20170822072754.1454.68800@wrigleys.postgresql.org>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox