Useful documentation removed from 9.5 docs

From: rasmus(at)mindplay(dot)dk
To: pgsql-docs(at)postgresql(dot)org
Subject: Useful documentation removed from 9.5 docs
Date: 2017-08-22 07:27:54
Message-ID: 20170822072754.1454.68800@wrigleys.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-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.

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message sahapasci 2017-08-22 13:36:31 pg_replication_slots page links
Previous Message David G. Johnston 2017-08-21 20:02:24 Re: intarray - benefits over regular int[]?