Thread: Intro enhancement proposal

Intro enhancement proposal

From
Elena Indrupskaya
Date:

Hello,

It occurred to me that adding some cross-references to intro.sgml could add value to the PostgreSQL 15 documentation through a possibility to immediately figure out what is meant by specific list items and through providing even better navigation. Details are in the attached patch.

Thank you.

--
Elena Indrupskaya
Lead Technical Writer
Postgres Professional http://www.postgrespro.com
Attachment

Re: Intro enhancement proposal

From
Daniel Gustafsson
Date:
> On 9 Aug 2022, at 13:13, Elena Indrupskaya <e.indrupskaya@postgrespro.ru> wrote:

> It occurred to me that adding some cross-references to intro.sgml could add value to the PostgreSQL 15 documentation
througha possibility to immediately figure out what is meant by specific list items and through providing even better
navigation.Details are in the attached patch. 

I haven't reviewed the patch in detail yet, but skimming it I think that seems
like a good idea.

--
Daniel Gustafsson        https://vmware.com/




Re: Intro enhancement proposal

From
Bruce Momjian
Date:
On Tue, Aug  9, 2022 at 01:18:25PM +0200, Daniel Gustafsson wrote:
> > On 9 Aug 2022, at 13:13, Elena Indrupskaya <e.indrupskaya@postgrespro.ru> wrote:
> 
> > It occurred to me that adding some cross-references to intro.sgml could add value to the PostgreSQL 15
documentationthrough a possibility to immediately figure out what is meant by specific list items and through providing
evenbetter navigation. Details are in the attached patch.
 
> 
> I haven't reviewed the patch in detail yet, but skimming it I think that seems
> like a good idea.

Agreed.  I adjusted some of the links and applied the attached patch to
master.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Only you can decide what is important to you.

Attachment