Re: 31.7.1. Initial Snapshot

From: Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>
To: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
Cc: splarv(at)ya(dot)ru, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: 31.7.1. Initial Snapshot
Date: 2023-10-11 17:19:44
Message-ID: 202310111719.h5b6ihmnpyku@alvherre.pgsql
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On 2023-Oct-11, David G. Johnston wrote:

> Or move 4 paragraphs of introductory material into its own section so that
> there are two sections and a brief sentence for an intro.

We have lots of other places where this (single-entry TOCs) happens. I
don't think we want to add spurious <section> tags in all those places
is going to be a good idea.

> I don't see a special case for a single section to be a productive use of
> time.

Well, it's the only case where it's not obvious what is going on, but I
agree it's not a great fix -- maybe we have some place where the
introductory material is very long and the first section is several
pagefuls below, and not having a TOC in that case wouldn't be great.

> Improved formatting overall for the chapter ToC has merit.

Great ...

--
Álvaro Herrera 48°01'N 7°57'E — https://www.EnterpriseDB.com/
"Crear es tan difícil como ser libre" (Elsa Triolet)

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2023-10-11 17:57:32 Re: 31.7.1. Initial Snapshot
Previous Message David G. Johnston 2023-10-11 16:45:57 Re: 31.7.1. Initial Snapshot