Re: The sub-categories do not have anchors on this page - Mailing list pgsql-docs

From David G. Johnston
Subject Re: The sub-categories do not have anchors on this page
Date
Msg-id CAKFQuwb-RXB1OZGx7zQy1JJx7JniYOLXJm+FSXhA3en-AcRhoQ@mail.gmail.com
Whole thread Raw
In response to Re: The sub-categories do not have anchors on this page  (Bruce Momjian <bruce@momjian.us>)
Responses Re: The sub-categories do not have anchors on this page
List pgsql-docs
On Thu, Dec 17, 2020 at 8:01 AM Bruce Momjian <bruce@momjian.us> wrote:
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.


+1

I would have used this numerous times recently when pointing people to where to find answers to their questions.

David J.

pgsql-docs by date:

Previous
From: "David G. Johnston"
Date:
Subject: Re: SELECT ... FOR UPDATE OF
Next
From: "Jonathan S. Katz"
Date:
Subject: Re: The sub-categories do not have anchors on this page