From: Bruce Momjian <bruce@momjian.us>
To: Alvaro Herrera <alvherre@alvh.no-ip.org>
Cc: Steven Pousty <steve.pousty@gmail.com>
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: The sub-categories do not have anchors on this page
Date: Thu, 17 Dec 2020 10:01:50 -0500
Message-ID: <20201217150150.GB23260@momjian.us> (raw)
In-Reply-To: <20201210205915.GA16798@alvherre.pgsql>
References: <CAKmB1PG=7eXXAPz1-UspEM7UMS5khDDYCL4+CCEi9wKWVDQ4zg@mail.gmail.com>
<20201210205915.GA16798@alvherre.pgsql>
On Thu, Dec 10, 2020 at 05:59:15PM -0300, Álvaro Herrera wrote:
> On 2020-Dec-10, Steven Pousty wrote:
>
> > They certainly do at the top of the page, that's why I sent the second
> > email. I was hoping to have anchors down the page where that actual topic
> > is. The rational for this is, when I write a blog post, teach a class, help
> > someone on slack... I can give them the URL right to the section I want
> > them to read. This anchor would prevent just giving the url to the whole
> > page and telling them to search for it.
>
> Ah -- so what you want is to have something like an icon (typically a
> chain link icon) that appears next to the title, and points to itself?
> Many sites do that. I think it's a useful idea and we should consider
> it, but it's a modification that would be done to the tooling and so
> it'd affect the whole documentation, not just this page.
I see your point --- these sub-sections are mixed with others on the
same page, so how would you know the link location? I usually dig
through the sgml and find one, or add one if it is missing, but that is
hardly scalable. Having a link icon makes sense --- even if they can
just click on the subsection title and the URL changes to that section
URL would be helpful.
--
Bruce Momjian <bruce@momjian.us> https://momjian.us
EnterpriseDB https://enterprisedb.com
The usefulness of a cup is in its emptiness, Bruce Lee
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: bruce@momjian.us, alvherre@alvh.no-ip.org, steve.pousty@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: The sub-categories do not have anchors on this page
In-Reply-To: <20201217150150.GB23260@momjian.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
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