Intro enhancement proposal

Started by Elena Indrupskayaabout 4 years ago3 messagesdocs
Beta feature

Hackorum builds and tests every patch posted to the lists, not only commitfest submissions. This is Hackorum's own CI rather than the PostgreSQL project's, and it is still under testing - please report anything that looks wrong.

never appliedCI history
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