pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedUseful documentation removed from 9.5 docs
2+ messages / 2 participants
[nested] [flat]
* Useful documentation removed from 9.5 docs
@ 2017-08-22 07:27 rasmus@mindplay.dk
2017-08-24 12:32 ` Re: Useful documentation removed from 9.5 docs Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 1 reply; 2+ messages in thread
From: rasmus@mindplay.dk @ 2017-08-22 07:27 UTC (permalink / raw)
To: 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.
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
^ permalink raw reply [nested|flat] 2+ messages in thread
* Re: Useful documentation removed from 9.5 docs
2017-08-22 07:27 Useful documentation removed from 9.5 docs rasmus@mindplay.dk
@ 2017-08-24 12:32 ` Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 0 replies; 2+ messages in thread
From: Tom Lane @ 2017-08-24 12:32 UTC (permalink / raw)
To: rasmus@mindplay.dk; +Cc: pgsql-docs
rasmus@mindplay.dk writes:
> 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.
That was changed because the advice was obsolete. See
https://www.postgresql.org/message-id/20150516123759.GB16100%40momjian.us
regards, tom lane
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
^ permalink raw reply [nested|flat] 2+ messages in thread
end of thread, other threads:[~2017-08-24 12:32 UTC | newest]
Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2017-08-22 07:27 Useful documentation removed from 9.5 docs rasmus@mindplay.dk
2017-08-24 12:32 ` Tom Lane <tgl@sss.pgh.pa.us>
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