Intro enhancement proposal

Started by Elena Indrupskayaover 3 years ago3 messagesdocs
Jump to latest
#1Elena Indrupskaya
e.indrupskaya@postgrespro.ru

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

Attachments:

intro_doc_psql.patchtext/x-patch; charset=UTF-8; name=intro_doc_psql.patchDownload+12-12
#2Daniel Gustafsson
daniel@yesql.se
In reply to: Elena Indrupskaya (#1)
Re: Intro enhancement proposal

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 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.

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/

#3Bruce Momjian
bruce@momjian.us
In reply to: Daniel Gustafsson (#2)
Re: Intro enhancement proposal

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 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.

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.

Attachments:

master.difftext/x-diff; charset=us-asciiDownload+12-12