MIME-Version: 1.0
References: <LO7P302MB2254ED63D99DEC176E8C50FEF86DA@LO7P302MB2254.GBRP302.PROD.OUTLOOK.COM>
 <0bd69007-f591-4584-aa13-037be2171aea@proxel.se> <CAM-ipWdfB3npDkT+xZbtBz_qAbewFE784BdY1a2zRUGmC1xPwA@mail.gmail.com>
In-Reply-To: <CAM-ipWdfB3npDkT+xZbtBz_qAbewFE784BdY1a2zRUGmC1xPwA@mail.gmail.com>
From: Philip Alger <paalger0@gmail.com>
Date: Thu, 19 Feb 2026 07:51:14 -0600
Message-ID: <CAPXBC8K0j-=zymexP+nxFAzKuDd9cz5HUi_sC4xvuPwJGAUB_w@mail.gmail.com>
Subject: Re: DOCS - Add introductory paragraph to Getting Started chapter
To: Dragos Andriciuc <dragos.andriciuc@percona.com>
Cc: Andreas Karlsson <andreas@proxel.se>, 
	"pgsql-hackers@postgresql.org" <pgsql-hackers@postgresql.org>
Content-Type: multipart/alternative; boundary="000000000000c5ecce064b2d9963"
Archived-At: <https://www.postgresql.org/message-id/CAPXBC8K0j-%3DzymexP%2BnxFAzKuDd9cz5HUi_sC4xvuPwJGAUB_w%40mail.gmail.com>
Precedence: bulk

--000000000000c5ecce064b2d9963
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Thu, Feb 19, 2026 at 3:58=E2=80=AFAM Dragos Andriciuc <
dragos.andriciuc@percona.com> wrote:

> Thanks for pointing that out. The intention was to add two paragraphs and
> it is now corrected to use
> two separate <para> tags. Attached is v2 of the patch.
>
> I have verified that the docs build and render correctly in HTML locally.
>
>>
>>
Hello,

It's always good to add more documentation. I wouldn't consider two single
sentences as separate paragraphs though.

However, I think these sentences can be combined into one.

For example:

This chapter provides a practical introduction to
<productname>PostgreSQL</productname>
by guiding you through software installation, basic architectural concepts,
and how to create and access
your first database.

I think this version combines the two essentially.

--=20
Best,
Phil Alger

--000000000000c5ecce064b2d9963
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div dir=3D"ltr"><br></div><br><div class=3D"gmail_quote g=
mail_quote_container"><div dir=3D"ltr" class=3D"gmail_attr">On Thu, Feb 19,=
 2026 at 3:58=E2=80=AFAM Dragos Andriciuc &lt;<a href=3D"mailto:dragos.andr=
iciuc@percona.com">dragos.andriciuc@percona.com</a>&gt; wrote:<br></div><bl=
ockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-lef=
t:1px solid rgb(204,204,204);padding-left:1ex"><div dir=3D"ltr"><div dir=3D=
"ltr">Thanks for pointing that out. The intention was to add two paragraphs=
 and it is now corrected to use<br>two separate &lt;para&gt; tags. Attached=
 is v2 of the patch.</div><div dir=3D"ltr"><br></div><div dir=3D"ltr">I hav=
e verified that the docs build and render correctly in HTML locally.<br></d=
iv></div><div class=3D"gmail_quote"><blockquote class=3D"gmail_quote" style=
=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding=
-left:1ex"><br></blockquote></div></blockquote></div><div><br></div><div>He=
llo,</div><div><br></div><div>It&#39;s always good to add more documentatio=
n. I wouldn&#39;t consider two single sentences as separate paragraphs thou=
gh.=C2=A0</div><div><br></div><div>However, I think these sentences can be =
combined into one.</div><div><br></div><div>For example:</div><div><br></di=
v><div>This chapter=C2=A0provides a practical introduction to &lt;productna=
me&gt;PostgreSQL&lt;/productname&gt;</div><div>by guiding you through softw=
are=C2=A0installation, basic architectural concepts, and how to create and =
access=C2=A0</div><div>your first=C2=A0database.</div><div><br></div><div>I=
 think this version combines the two essentially.</div><div><br></div><span=
 class=3D"gmail_signature_prefix">-- </span><br><div dir=3D"ltr" class=3D"g=
mail_signature"><div dir=3D"ltr">Best,=C2=A0<div>Phil Alger</div></div></di=
v></div>

--000000000000c5ecce064b2d9963--