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

2020-12-10 Thread Alvaro Herrera
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.




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

2020-12-10 Thread Steven Pousty
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 
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.
>


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

2020-12-10 Thread Steven Pousty
On Thu, Dec 10, 2020 at 12:42 PM 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.
>
> 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 
> 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.


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

2020-12-10 Thread Alvaro Herrera
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.