Re: The sub-categories do not have anchors on this page

From: "Jonathan S(dot) Katz" <jkatz(at)postgresql(dot)org>
To: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>, Bruce Momjian <bruce(at)momjian(dot)us>
Cc: Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>, Steven Pousty <steve(dot)pousty(at)gmail(dot)com>, Pg Docs <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: The sub-categories do not have anchors on this page
Date: 2020-12-17 15:15:12
Message-ID: e8a1fe39-def4-5dca-a2f3-de9650c0ce03@postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On 12/17/20 10:11 AM, David G. Johnston wrote:
> On Thu, Dec 17, 2020 at 8:01 AM Bruce Momjian <bruce(at)momjian(dot)us
> <mailto:bruce(at)momjian(dot)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.

Something to help with this has been on my backlog for a bit. We may be
able to resolve this with the pgweb CSS layer.

Jonathan

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2020-12-17 15:50:16 Re: where can I get the table definition and data in the documention?
Previous Message David G. Johnston 2020-12-17 15:11:07 Re: The sub-categories do not have anchors on this page