Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps  (TLS1.3) tls
 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.94.2)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1qwnej-00EKz8-1s
	for pgsql-docs@arkaria.postgresql.org; Sat, 28 Oct 2023 18:03:29 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.94.2)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1qwneh-005BHa-Kz
	for pgsql-docs@arkaria.postgresql.org; Sat, 28 Oct 2023 18:03:27 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
	by malur.postgresql.org with esmtps  (TLS1.3) tls
 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.94.2)
	(envelope-from <bruce@momjian.us>)
	id 1qwneh-005BH5-DM
	for pgsql-docs@lists.postgresql.org; Sat, 28 Oct 2023 18:03:27 +0000
Received: from momjian.us ([72.94.173.45])
	by magus.postgresql.org with esmtps  (TLS1.3) tls
 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.94.2)
	(envelope-from <bruce@momjian.us>)
	id 1qwnee-003Pdf-BI
	for pgsql-docs@lists.postgresql.org; Sat, 28 Oct 2023 18:03:26 +0000
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=momjian.us;
	s=2023062407; h=In-Reply-To:Content-Type:MIME-Version:References:Message-ID:
	Subject:Cc:To:From:Date:Sender:Reply-To:Content-Transfer-Encoding:Content-ID:
	Content-Description; bh=PNgVpeV+UeVCyB/+IHPltF7wEjsEthJuw127b31ww9k=; b=yrKBb
	TRv6qhRMFTwioP6C/wqCKn/qvPdHfKgNarNzHU2sWljz6M/AsmigXCeOKUUbuNnBThPd1NcVYUoVx
	OWfJ5tIQqGaT4qyIVbb0rgwVxUEsV1ZPvn9uT2coh68ckCNRMZnLrk2+PzyJnL3RlObDEkGXNLOXI
	45dS+HX7DtqGinm7veRC0mKtC9f3ZnxHGXhzJ8MsNnBs+RgTB7MNoomiksDDWj4RZ7gvAjOufpBvI
	bafQKrux51QtzFE8oQYAdbAX6ZzuNwWLDmsFF9e5HaJNQc83Paz9tBbDDVVIgNXyPw8lIp082pW8e
	aRuEwCJu2Yg1Q8LrYfvfotpbUfe5A==;
Received: from bruce by momjian.us with local (Exim 4.96)
	(envelope-from <bruce@momjian.us>)
	id 1qwneZ-008sEW-08;
	Sat, 28 Oct 2023 14:03:19 -0400
Date: Sat, 28 Oct 2023 14:03:19 -0400
From: Bruce Momjian <bruce@momjian.us>
To: Daniel Gustafsson <daniel@yesql.se>
Cc: Elena Indrupskaya <e.indrupskaya@postgrespro.ru>,
	pgsql-docs@lists.postgresql.org
Subject: Re: Intro enhancement proposal
Message-ID: <ZT1M5yCYLKj5CFOs@momjian.us>
References: <1a666b2e-d373-1c94-1005-1700e023670d@postgrespro.ru>
 <15E5E765-79C6-4ADF-A508-EF641B592601@yesql.se>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="waHSzsDjkH1rYAhj"
Content-Disposition: inline
In-Reply-To: <15E5E765-79C6-4ADF-A508-EF641B592601@yesql.se>
List-Id: <pgsql-docs.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-docs@lists.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-docs>
Archived-At: 
 <https://www.postgresql.org/message-id/ZT1M5yCYLKj5CFOs%40momjian.us>
Precedence: bulk


--waHSzsDjkH1rYAhj
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

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.

--waHSzsDjkH1rYAhj
Content-Type: text/x-diff; charset=us-ascii
Content-Disposition: attachment; filename="master.diff"

diff --git a/doc/src/sgml/intro.sgml b/doc/src/sgml/intro.sgml
index 63eda059f0..fec72481b5 100644
--- a/doc/src/sgml/intro.sgml
+++ b/doc/src/sgml/intro.sgml
@@ -101,22 +101,22 @@
 
    <itemizedlist spacing="compact">
     <listitem>
-     <simpara>complex queries</simpara>
+     <simpara><link linkend="sql">complex queries</link></simpara>
     </listitem>
     <listitem>
-     <simpara>foreign keys</simpara>
+     <simpara><link linkend="ddl-constraints-fk">foreign keys</link></simpara>
     </listitem>
     <listitem>
-     <simpara>triggers</simpara>
+     <simpara><link linkend="triggers">triggers</link></simpara>
     </listitem>
     <listitem>
-     <simpara>updatable views</simpara>
+     <simpara><link linkend="sql-createview-updatable-views">updatable views</link></simpara>
     </listitem>
     <listitem>
-     <simpara>transactional integrity</simpara>
+     <simpara><link linkend="transaction-iso">transactional integrity</link></simpara>
     </listitem>
     <listitem>
-     <simpara>multiversion concurrency control</simpara>
+     <simpara><link linkend="mvcc">multiversion concurrency control</link></simpara>
     </listitem>
    </itemizedlist>
 
@@ -125,22 +125,22 @@
 
    <itemizedlist spacing="compact">
     <listitem>
-     <simpara>data types</simpara>
+     <simpara><link linkend="datatype">data types</link></simpara>
     </listitem>
     <listitem>
-     <simpara>functions</simpara>
+     <simpara><link linkend="functions">functions</link></simpara>
     </listitem>
     <listitem>
-     <simpara>operators</simpara>
+     <simpara><link linkend="functions">operators</link></simpara>
     </listitem>
     <listitem>
-     <simpara>aggregate functions</simpara>
+     <simpara><link linkend="functions-aggregate">aggregate functions</link></simpara>
     </listitem>
     <listitem>
-     <simpara>index methods</simpara>
+     <simpara><link linkend="indexes">index methods</link></simpara>
     </listitem>
     <listitem>
-     <simpara>procedural languages</simpara>
+     <simpara><link linkend="server-programming">procedural languages</link></simpara>
     </listitem>
    </itemizedlist>
   </para>

--waHSzsDjkH1rYAhj--