public inbox for [email protected]  

help / color / mirror / Atom feed

From: Dragos Andriciuc <[email protected]>
To: Andreas Karlsson <[email protected]>
Cc: [email protected] <[email protected]>
Subject: Re: DOCS - Add introductory paragraph to Getting Started chapter
Date: Thu, 19 Feb 2026 11:58:39 +0200
Message-ID: <CAM-ipWdfB3npDkT+xZbtBz_qAbewFE784BdY1a2zRUGmC1xPwA@mail.gmail.com> (raw)
In-Reply-To: <[email protected]>
References: <LO7P302MB2254ED63D99DEC176E8C50FEF86DA@LO7P302MB2254.GBRP302.PROD.OUTLOOK.COM>
	<[email protected]>

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.

On Wed, Feb 18, 2026 at 7:25 PM Andreas Karlsson <[email protected]> wrote:

> On 2/18/26 10:28 AM, Dragos Andriciuc wrote:
> > The "Getting Started" chapter currently lacks an introductory paragraph
> > explaining its scope.
> >
> > This patch adds a brief introduction describing the topics covered in
> > the chapter.
> >
> > Patch attached.
>
> I have not looked at the actual contents of the change but did you
> intend to add one or two paragraphs? You intent is a bit unclear since
> you have added a double newline within a <para> tag. If you intended two
> paragraphs it should be two <para> tags and if not there shouldn't be a
> double newline.
>
> Have you set it up so you can render the documentation to HTML locally?
>
> Andreas
>
>
>


Attachments:

  [application/octet-stream] v2-0001-Add-introductory-paragraph-to-Getting-Started-chapter.patch (1.1K, 3-v2-0001-Add-introductory-paragraph-to-Getting-Started-chapter.patch)
  download | inline diff:
From c52769a10a13aeecf81e9b15ca59012ff77a0477 Mon Sep 17 00:00:00 2001
From: Dragos Andriciuc <[email protected]>
Date: Tue, 17 Feb 2026 12:25:03 +0200
Subject: [PATCH] Add introductory paragraph to Getting Started chapter

v2:
- Add paragraph tag to second paragraph
---
 doc/src/sgml/start.sgml | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/doc/src/sgml/start.sgml b/doc/src/sgml/start.sgml
index 0263a700591..8ab857aa0a6 100644
--- a/doc/src/sgml/start.sgml
+++ b/doc/src/sgml/start.sgml
@@ -3,6 +3,17 @@
  <chapter id="tutorial-start">
   <title>Getting Started</title>
 
+   <para>
+   This chapter provides a practical introduction to working with <productname>PostgreSQL</productname>.
+   It describes how to install the software, explains basic architectural concepts, and shows how 
+   to create and access a database.
+   </para>
+
+   <para>
+   The purpose of this chapter is to help you set up a working <productname>PostgreSQL</productname> 
+   environment and become familiar with the fundamental components involved in everyday use.
+   </para>
+
   <sect1 id="tutorial-install">
    <title>Installation</title>
 
-- 
2.43.0

view thread (3+ messages)

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected]
  Subject: Re: DOCS - Add introductory paragraph to Getting Started chapter
  In-Reply-To: <CAM-ipWdfB3npDkT+xZbtBz_qAbewFE784BdY1a2zRUGmC1xPwA@mail.gmail.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox