pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedThe sub-categories do not have anchors on this page
9+ messages / 6 participants
[nested] [flat]
* The sub-categories do not have anchors on this page
@ 2020-12-02 20:21 PG Doc comments form <noreply@postgresql.org>
0 siblings, 2 replies; 9+ messages in thread
From: PG Doc comments form @ 2020-12-02 20:21 UTC (permalink / raw)
To: pgsql-docs@lists.postgresql.org; +Cc: steve.pousty@gmail.com
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/13/plpgsql-statements.html
Description:
Hey Kind Doc People
I was hoping we could add sub-anchors for each of the sections on this page.
It would make it easier to link to the specific content of interest
Thanks
Steve
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: The sub-categories do not have anchors on this page
@ 2020-12-02 20:59 Bruce Momjian <bruce@momjian.us>
parent: PG Doc comments form <noreply@postgresql.org>
1 sibling, 0 replies; 9+ messages in thread
From: Bruce Momjian @ 2020-12-02 20:59 UTC (permalink / raw)
To: steve.pousty@gmail.com; pgsql-docs@lists.postgresql.org
On Wed, Dec 2, 2020 at 08:21:27PM +0000, PG Doc comments form wrote:
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/13/plpgsql-statements.html
> Description:
>
> Hey Kind Doc People
> I was hoping we could add sub-anchors for each of the sections on this page.
> It would make it easier to link to the specific content of interest
Yes, I would like more sub-anchors too. Sometimes I add them when
creating the major release notes, but other than that, I don't know
anyone working on adding more.
--
Bruce Momjian <bruce@momjian.us> https://momjian.us
EnterpriseDB https://enterprisedb.com
The usefulness of a cup is in its emptiness, Bruce Lee
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: The sub-categories do not have anchors on this page
@ 2020-12-10 19:31 Alvaro Herrera <alvherre@alvh.no-ip.org>
parent: PG Doc comments form <noreply@postgresql.org>
1 sibling, 1 reply; 9+ messages in thread
From: Alvaro Herrera @ 2020-12-10 19:31 UTC (permalink / raw)
To: steve.pousty@gmail.com; pgsql-docs@lists.postgresql.org
Hello
On 2020-Dec-02, PG Doc comments form wrote:
> Page: https://www.postgresql.org/docs/13/plpgsql-statements.html
> Description:
>
> Hey Kind Doc People
> I was hoping we could add sub-anchors for each of the sections on this page.
> It would make it easier to link to the specific content of interest
Exactly where would you want more anchors in this page? The
sections ("42.5.6. Doing Nothing At All") already have them.
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: The sub-categories do not have anchors on this page
@ 2020-12-10 20:42 Steven Pousty <steve.pousty@gmail.com>
parent: Alvaro Herrera <alvherre@alvh.no-ip.org>
0 siblings, 2 replies; 9+ messages in thread
From: Steven Pousty @ 2020-12-10 20:42 UTC (permalink / raw)
To: Alvaro Herrera <alvherre@alvh.no-ip.org>; +Cc: pgsql-docs@lists.postgresql.org
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.
I guess I could also just copy the link in the TOC at the top of the page
that points to the header I want.
So not a hig priority request but certainly easier if the anchor is right
there to copy when I am reading the section.
Thanks
Steve
On Thu, Dec 10, 2020 at 11:31 AM Alvaro Herrera <alvherre@alvh.no-ip.org>
wrote:
> Hello
>
> On 2020-Dec-02, PG Doc comments form wrote:
>
> > Page: https://www.postgresql.org/docs/13/plpgsql-statements.html
> > Description:
> >
> > Hey Kind Doc People
> > I was hoping we could add sub-anchors for each of the sections on this
> page.
> > It would make it easier to link to the specific content of interest
>
> Exactly where would you want more anchors in this page? The
> sections ("42.5.6. Doing Nothing At All") already have them.
>
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: The sub-categories do not have anchors on this page
@ 2020-12-10 20:43 Steven Pousty <steve.pousty@gmail.com>
parent: Steven Pousty <steve.pousty@gmail.com>
1 sibling, 0 replies; 9+ messages in thread
From: Steven Pousty @ 2020-12-10 20:43 UTC (permalink / raw)
To: Alvaro Herrera <alvherre@alvh.no-ip.org>; +Cc: pgsql-docs@lists.postgresql.org
On Thu, Dec 10, 2020 at 12:42 PM Steven Pousty <steve.pousty@gmail.com>
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.
>
> I guess I could also just copy the link in the TOC at the top of the page
> that points to the header I want.
>
> So not a hig priority request but certainly easier if the anchor is right
> there to copy when I am reading the section.
>
> Thanks
> Steve
>
> On Thu, Dec 10, 2020 at 11:31 AM Alvaro Herrera <alvherre@alvh.no-ip.org>
> wrote:
>
>> Hello
>>
>> On 2020-Dec-02, PG Doc comments form wrote:
>>
>> > Page: https://www.postgresql.org/docs/13/plpgsql-statements.html
>> > Description:
>> >
>> > Hey Kind Doc People
>> > I was hoping we could add sub-anchors for each of the sections on this
>> page.
>> > It would make it easier to link to the specific content of interest
>>
>> Exactly where would you want more anchors in this page? The
>> sections ("42.5.6. Doing Nothing At All") already have them.
>>
>
Sorry I forgot to put the reply after the quote. Reply on top is the
default behavior in google and I just forget sometimes.
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: The sub-categories do not have anchors on this page
@ 2020-12-10 20:59 Alvaro Herrera <alvherre@alvh.no-ip.org>
parent: Steven Pousty <steve.pousty@gmail.com>
1 sibling, 1 reply; 9+ messages in thread
From: Alvaro Herrera @ 2020-12-10 20:59 UTC (permalink / raw)
To: Steven Pousty <steve.pousty@gmail.com>; +Cc: pgsql-docs@lists.postgresql.org
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.
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: The sub-categories do not have anchors on this page
@ 2020-12-17 15:01 Bruce Momjian <bruce@momjian.us>
parent: Alvaro Herrera <alvherre@alvh.no-ip.org>
0 siblings, 1 reply; 9+ messages in thread
From: Bruce Momjian @ 2020-12-17 15:01 UTC (permalink / raw)
To: Alvaro Herrera <alvherre@alvh.no-ip.org>; +Cc: Steven Pousty <steve.pousty@gmail.com>; pgsql-docs@lists.postgresql.org
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
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: The sub-categories do not have anchors on this page
@ 2020-12-17 15:11 David G. Johnston <david.g.johnston@gmail.com>
parent: Bruce Momjian <bruce@momjian.us>
0 siblings, 1 reply; 9+ messages in thread
From: David G. Johnston @ 2020-12-17 15:11 UTC (permalink / raw)
To: Bruce Momjian <bruce@momjian.us>; +Cc: Alvaro Herrera <alvherre@alvh.no-ip.org>; Steven Pousty <steve.pousty@gmail.com>; Pg Docs <pgsql-docs@lists.postgresql.org>
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.
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: The sub-categories do not have anchors on this page
@ 2020-12-17 15:15 Jonathan S. Katz <jkatz@postgresql.org>
parent: David G. Johnston <david.g.johnston@gmail.com>
0 siblings, 0 replies; 9+ messages in thread
From: Jonathan S. Katz @ 2020-12-17 15:15 UTC (permalink / raw)
To: David G. Johnston <david.g.johnston@gmail.com>; Bruce Momjian <bruce@momjian.us>; +Cc: Alvaro Herrera <alvherre@alvh.no-ip.org>; Steven Pousty <steve.pousty@gmail.com>; Pg Docs <pgsql-docs@lists.postgresql.org>
On 12/17/20 10:11 AM, David G. Johnston wrote:
> On Thu, Dec 17, 2020 at 8:01 AM Bruce Momjian <bruce@momjian.us
> <mailto: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.
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
Attachments:
OpenPGP_signature (application/pgp-signature, 839B) download
^ permalink raw reply [nested|flat] 9+ messages in thread
end of thread, other threads:[~2020-12-17 15:15 UTC | newest]
Thread overview: 9+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2020-12-02 20:21 The sub-categories do not have anchors on this page PG Doc comments form <noreply@postgresql.org>
2020-12-02 20:59 ` Bruce Momjian <bruce@momjian.us>
2020-12-10 19:31 ` Alvaro Herrera <alvherre@alvh.no-ip.org>
2020-12-10 20:42 ` Steven Pousty <steve.pousty@gmail.com>
2020-12-10 20:43 ` Steven Pousty <steve.pousty@gmail.com>
2020-12-10 20:59 ` Alvaro Herrera <alvherre@alvh.no-ip.org>
2020-12-17 15:01 ` Bruce Momjian <bruce@momjian.us>
2020-12-17 15:11 ` David G. Johnston <david.g.johnston@gmail.com>
2020-12-17 15:15 ` Jonathan S. Katz <jkatz@postgresql.org>
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