From b7e4529a99799f13ce4b701d19b2f625b548f4ac Mon Sep 17 00:00:00 2001
From: Nathan Bossart <nathan@postgresql.org>
Date: Thu, 18 Sep 2025 14:01:23 -0500
Subject: [PATCH v3 1/1] add major features to v18 release notes

---
 doc/src/sgml/release-18.sgml | 60 +++++++++++++++++++++++++++++++++++-
 1 file changed, 59 insertions(+), 1 deletion(-)

diff --git a/doc/src/sgml/release-18.sgml b/doc/src/sgml/release-18.sgml
index 46b4787a191..f3f44552c70 100644
--- a/doc/src/sgml/release-18.sgml
+++ b/doc/src/sgml/release-18.sgml
@@ -21,7 +21,65 @@
 
     <listitem>
      <para>
-      (to be completed)
+      An asynchronous I/O subsystem (AIO) that can improve performance of
+      of sequential scans, bitmap heap scans, vacuums, and other operations.
+     </para>
+    </listitem>
+
+    <listitem>
+     <para>
+      <link linkend="pgupgrade"><application>pg_upgrade</application></link>
+      now maintains optimizer statistics through upgrade.
+     </para>
+    </listitem>
+
+    <listitem>
+     <para>
+      Support for "skip scan" lookups that allow
+      <link linkend="indexes-multicolumn">multicolumn B-tree indexes</link>
+      to be used in more cases.
+     </para>
+    </listitem>
+
+    <listitem>
+     <para>
+     <link linkend="func_uuid_gen_table"><function>uuidv7()</function></link>
+      function for generating timestamp-ordered
+      <link linkend="datatype-uuid">UUIDs</link>.
+     </para>
+    </listitem>
+
+    <listitem>
+     <para>
+      Virtual
+      <link linkend="sql-createtable-parms-generated-stored">generated columns</link>
+      that compute their values during read operations.  This is now the default
+      for generated columns.
+     </para>
+    </listitem>
+
+    <listitem>
+     <para>
+      <link linkend="auth-oauth">OAuth authentication</link> support.
+     </para>
+    </listitem>
+
+    <listitem>
+     <para>
+      <literal>OLD</literal> and <literal>NEW</literal> support for
+      <link linkend="dml-returning"><literal>RETURNING</literal></link> clauses
+      in <xref linkend="sql-insert"/>, <xref linkend="sql-update"/>,
+      <xref linkend="sql-delete"/>, and <xref linkend="sql-merge"/> commands.
+     </para>
+    </listitem>
+
+    <listitem>
+     <para>
+      Temporal constraints, or constraints over ranges, for
+      <link linkend="sql-createtable-parms-primary-key">PRIMARY KEY</link>,
+      <link linkend="sql-createtable-parms-unique">UNIQUE</link>, and
+      <link linkend="sql-createtable-parms-references">FOREIGN KEY</link>
+      constraints.
      </para>
     </listitem>
    </itemizedlist>
-- 
2.39.5 (Apple Git-154)