[DOCS] Useful documentation removed from 9.5 docs - Mailing list pgsql-docs

From rasmus@mindplay.dk
Subject [DOCS] Useful documentation removed from 9.5 docs
Date
Msg-id 20170822072754.1454.68800@wrigleys.postgresql.org
Whole thread Raw
Responses Re: [DOCS] Useful documentation removed from 9.5 docs
List 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.


pgsql-docs by date:

Previous
From: "David G. Johnston"
Date:
Subject: Re: [DOCS] intarray - benefits over regular int[]?
Next
From: sahapasci@gmail.com
Date:
Subject: [DOCS] pg_replication_slots page links