Re: Inconsistent index links - Mailing list pgsql-docs

From Thom Brown
Subject Re: Inconsistent index links
Date
Msg-id AANLkTikUh3JrDpwAkaJkQ0ATC4=g62pSk54_=Yv5S5ya@mail.gmail.com
Whole thread Raw
In response to Re: Inconsistent index links  (Alvaro Herrera <alvherre@commandprompt.com>)
List pgsql-docs
On 1 September 2010 19:57, Alvaro Herrera <alvherre@commandprompt.com> wrote:
> Excerpts from Thom Brown's message of mié sep 01 14:21:59 -0400 2010:
>> The avg function is confusingly indexed only as "average", which
>> shouldn't really be a problem... unless someone types in "avg" into
>> their browser's find box.  Maybe this should have "average" as a
>> primary term and "avg" as a secondary (with Pavel's 'median" function
>> to be added later).
>
> I think we should have index entries for function names, aggregate or
> not.  Perhaps <primary>avg</primary><secondary>aggregate function</> ?
> Hmm, or maybe the other way around, so that all aggregates are listed
> together in the index?  Not sure.  (but surely we don't want to have all
> functions lumped together in a single "<primary>function</>").

I think the problem with that is if someone's scrolling down the page
looking for a function name alphabetically, they probably won't find
it if it's been bundled into a group.  If they did want to see a list
of aggregate functions, they already have the option to look up
"aggregate functions > built-in" in the index.

> For some reason I don't like <primary>average</><secondary>avg</>, but
> then I don't like the current <primary>average</> either.

We could just replace that with <primary>avg</>, because at least then
it can be found by a browser's Find functionality.

--
Thom Brown
Twitter: @darkixion
IRC (freenode): dark_ixion
Registered Linux user: #516935

pgsql-docs by date:

Previous
From: "Joshua D. Drake"
Date:
Subject: Re: [pgsql-www] Example indenting
Next
From: Josh Berkus
Date:
Subject: Correction: datatypes are not "faster"