agora inbox for pgsql-docs@postgresql.org  

help / color / mirror / Atom feed

From: Jonathan S. Katz <jkatz@postgresql.org>
To: Daniel Gustafsson <daniel@yesql.se>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: David Rowley <dgrowleyml@gmail.com>
Cc: Muhammad Ikram <mmikram@gmail.com>
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: A minor bug in doc. Hovering over heading shows # besides it.
Date: Thu, 18 Jul 2024 14:03:40 -0400
Message-ID: <c2e3bc0c-5717-4268-b4bd-c1b88a5c0799@postgresql.org> (raw)
In-Reply-To: <30D9BFAE-A61D-4382-A4A9-7E55082047EC@yesql.se>
References: <CAGeimVqnkm7X-cXNNXjdGL2u5N29RiFtcpUzPuW1-VYACe6m+Q@mail.gmail.com>
	<CAApHDvq74df8y+_ef1X_EQsurUfqyNPWf-mYfSxbph5Of+4Z0A@mail.gmail.com>
	<3648828.1721279892@sss.pgh.pa.us>
	<5C909F36-9412-4CA0-BC86-43B4632CD17C@yesql.se>
	<3701766.1721310545@sss.pgh.pa.us>
	<30D9BFAE-A61D-4382-A4A9-7E55082047EC@yesql.se>

On 7/18/24 1:59 PM, Daniel Gustafsson wrote:
>> On 18 Jul 2024, at 15:49, Tom Lane <tgl@sss.pgh.pa.us> wrote:
>>
>> Daniel Gustafsson <daniel@yesql.se> writes:
>>> While not a standard the pilcrow [0] is, AFAICT from a bit of looking at other
>>> docs, commonly used for this.  There is a lot of variability though so
>>> whichever we choose it will be wrong one for someone.
>>
>> I like this suggestion better because that's U+00B6, ie part of
>> LATIN-1, so it's *far* more likely to render correctly everywhere
>> than U+01F517 is.  We could also consider the section sign §
>> (U+00A7).
>>
>> In any case, a tooltip would help reduce confusion.
> 
> Looking a bit closer, the Python documentation does just this, a pilcrow with a
> tool-tip ("Link to this heading") when hovering over it

I forgot why we went with the "#" and not the (TIL the name) pilcrow 
symbol, but I'm generally used to seeing the pilcrow when I browse docs 
and may have voiced that at the time (though the record may show 
otherwise). So +1 to that.

Thanks,

Jonathan



Attachments:

  [application/pgp-signature] OpenPGP_signature.asc (839B, ../c2e3bc0c-5717-4268-b4bd-c1b88a5c0799@postgresql.org/2-OpenPGP_signature.asc)
  download

view thread (36+ messages)  latest in thread

Message-ID: <c2e3bc0c-5717-4268-b4bd-c1b88a5c0799@postgresql.org>
Permalink:  ../c2e3bc0c-5717-4268-b4bd-c1b88a5c0799@postgresql.org/
Also on:    postgresql.org/message-id/c2e3bc0c-5717-4268-b4bd-c1b88a5c0799@postgresql.org

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: jkatz@postgresql.org, daniel@yesql.se, tgl@sss.pgh.pa.us, dgrowleyml@gmail.com, mmikram@gmail.com, pgsql-docs@lists.postgresql.org
  Subject: Re: A minor bug in doc. Hovering over heading shows # besides it.
  In-Reply-To: <c2e3bc0c-5717-4268-b4bd-c1b88a5c0799@postgresql.org>

* 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