agora inbox for pgsql-docs@postgresql.org  

help / color / mirror / Atom feed

From: Erik Wienhold <ewie@ewie.name>
To: Jai Sharma <jai@jai.moe>
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: Docs search does not work for the "@>" operator
Date: Fri, 7 Mar 2025 03:12:17 +0100
Message-ID: <f50c3e36-9f10-4da1-ac77-7ffcb7d93f67@ewie.name> (raw)
In-Reply-To: <875af479-d548-456d-bc6c-e196e76a5407@app.fastmail.com>
References: <875af479-d548-456d-bc6c-e196e76a5407@app.fastmail.com>

On 2025-03-03 19:35 +0100, Jai Sharma wrote:
> When searching on the Postgres docs website, searching with the strings
> `@>` or `"@>"` returns no results.
> 
> Ordinarily, I would expect to see results returned including this page (which
> was the page I was looking for):
> https://www.postgresql.org/docs/17/functions-range.html

Any operator, in fact, because pgweb implements its search with
plainto_tsquery [1] which ignores punctuation.

> Can the search be updated to work with these characters please?

I don't see how because information about these operators (or any other
punctuation) is lost when pages are converted to tsvector by the web
crawler.  Maybe a separate operator index where you could search with
ctrl+f is an option.  But I don't know if that is feasible with the
current document structure without having to maintain basically two
separate operator docs.  But DocBook can certainly index symbols [2].

[1] https://git.postgresql.org/gitweb/?p=pgweb.git;a=blob;f=tools/search/sql/functions.sql;h=9ee5c4a51c0...
[2] https://www.postgresql.org/docs/current/bookindex.html#indexdiv-Symbols

-- 
Erik Wienhold

view thread (5+ messages)

Message-ID: <f50c3e36-9f10-4da1-ac77-7ffcb7d93f67@ewie.name>
Permalink:  ../f50c3e36-9f10-4da1-ac77-7ffcb7d93f67@ewie.name/
Also on:    postgresql.org/message-id/f50c3e36-9f10-4da1-ac77-7ffcb7d93f67@ewie.name

reply

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: ewie@ewie.name, jai@jai.moe, pgsql-docs@lists.postgresql.org
  Subject: Re: Docs search does not work for the "@>" operator
  In-Reply-To: <f50c3e36-9f10-4da1-ac77-7ffcb7d93f67@ewie.name>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox