postgres.git / summary / log / commit / refs

commit    2eb3ec8f496126cd3064db8747279f4f1b24b19b
Author:   Tom Lane <tgl@sss.pgh.pa.us>
Date:     Tue Apr 12 22:21:04 2022 +0000
First released in: 15.0, 10.21, 11.16, 12.11, 13.7, 14.3

    Doc: tweak textsearch.sgml for SEO purposes.
    
    Google seems to like to return textsearch.html for queries about
    GIN and GiST indexes, even though it's not a primary reference
    for either.  It seems likely that that's because those keywords
    appear in the page title.  Since "GIN and GiST Index Types" is
    not a very apposite title for this material anyway, rename the
    section in hopes of stopping that.
    
    Also provide explicit links to the GIN and GiST chapters, to help
    anyone who finds their way to this page regardless.
    
    Per gripe from Jan Piotrowski.  Back-patch to supported branches.
    (Unfortunately Google is likely to continue returning the 9.1
    version of this page, but improving that situation is a matter
    for the www team.)
    
    Discussion: https://postgr.es/m/164978902252.1276550.9330175733459697101@wrigleys.postgresql.org


 doc/src/sgml/textsearch.sgml | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/doc/src/sgml/textsearch.sgml b/doc/src/sgml/textsearch.sgml
index a9af28b34d0..545397d4cba 100644
--- a/doc/src/sgml/textsearch.sgml
+++ b/doc/src/sgml/textsearch.sgml
@@ -3602,7 +3602,7 @@ SELECT plainto_tsquery('supernovae stars');
  </sect1>
 
  <sect1 id="textsearch-indexes">
-  <title>GIN and GiST Index Types</title>
+  <title>Preferred Index Types for Text Search</title>
 
   <indexterm zone="textsearch-indexes">
    <primary>text search</primary>
@@ -3611,10 +3611,16 @@ SELECT plainto_tsquery('supernovae stars');
 
   <para>
    There are two kinds of indexes that can be used to speed up full text
-   searches.
+   searches:
+   <link linkend="gin"><acronym>GIN</acronym></link> and
+   <link linkend="gist"><acronym>GiST</acronym></link>.
    Note that indexes are not mandatory for full text searching, but in
    cases where a column is searched on a regular basis, an index is
    usually desirable.
+  </para>
+
+  <para>
+   To create such an index, do one of:
 
    <variablelist>
 


[parent: af3e3a9b4f52]