Re: 31.7.1. Initial Snapshot - Mailing list pgsql-docs

From Alvaro Herrera
Subject Re: 31.7.1. Initial Snapshot
Date
Msg-id 202310111719.h5b6ihmnpyku@alvherre.pgsql
Whole thread Raw
In response to Re: 31.7.1. Initial Snapshot  ("David G. Johnston" <david.g.johnston@gmail.com>)
Responses Re: 31.7.1. Initial Snapshot
List 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)



pgsql-docs by date:

Previous
From: "David G. Johnston"
Date:
Subject: Re: 31.7.1. Initial Snapshot
Next
From: Tom Lane
Date:
Subject: Re: 31.7.1. Initial Snapshot