- for whatever reason, Insert.values() with multi values wasn't

in the 0.8 migration, so let's just add that

Author: zzzeek

doc/build/changelog/changelog_08.rst

@@ -2156,6 +2156,10 @@
       Supported by Postgresql, SQLite, and MySQL.
       Big thanks to Idan Kamara for doing the legwork on this one.
 
+      .. seealso::
+
+        :ref:`feature_2623`
+
     .. change::
         :tags: oracle, bug
         :tickets: 2620

doc/build/changelog/migration_08.rst

@@ -683,6 +683,30 @@ as more string, integer and date operators.
 
 :ticket:`2547`
 
+.. _feature_2623:
+
+Multiple-VALUES support for Insert
+-----------------------------------
+
+The :meth:`.Insert.values` method now supports a list of dictionaries,
+which will render a multi-VALUES statement such as
+``VALUES (<row1>), (<row2>), ...``.  This is only relevant to backends which
+support this syntax, including Postgresql, SQLite, and MySQL.  It is
+not the same thing as the usual ``executemany()`` style of INSERT which
+remains unchanged::
+
+    users.insert().values([
+                        {"name": "some name"},
+                        {"name": "some other name"},
+                        {"name": "yet another name"},
+                    ])
+
+.. seealso::
+
+    :meth:`.Insert.values`
+
+:ticket:`2623`
+
 Type Expressions
 -----------------