Re: DOCS - Add introductory paragraph to Getting Started chapter

From: Philip Alger <paalger0(at)gmail(dot)com>
To: Dragos Andriciuc <dragos(dot)andriciuc(at)percona(dot)com>
Cc: Andreas Karlsson <andreas(at)proxel(dot)se>, "pgsql-hackers(at)postgresql(dot)org" <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: DOCS - Add introductory paragraph to Getting Started chapter
Date: 2026-02-19 13:51:14
Message-ID: CAPXBC8K0j-=zymexP+nxFAzKuDd9cz5HUi_sC4xvuPwJGAUB_w@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Thu, Feb 19, 2026 at 3:58 AM Dragos Andriciuc <
dragos(dot)andriciuc(at)percona(dot)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.

--
Best,
Phil Alger

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Jonathan Gonzalez V. 2026-02-19 14:18:34 Re: Make PGOAUTHCAFILE in libpq-oauth work out of debug mode
Previous Message Hayato Kuroda (Fujitsu) 2026-02-19 13:06:34 RE: Selectively invalidate caches in pgoutput module