go with List rather than Iterable because Iterable is just a PITA to deal with

Author: gavinking

api/src/main/java/jakarta/data/repository/Delete.java

@@ -65,7 +65,7 @@
  * to be deleted is the primary entity type of the repository. The method return type must be {@code void}, {@code int},
  * or {@code long}. Every parameter of the annotated method must have exactly the same name (the parameter name in the
  * Java source, or a name assigned by {@link By @By}) as a persistent field or property of the entity class and be of
- * type {@code T}, {@code T[]}, or {@code Iterable<T>} where {@code T} is the type of the field or property. Parameters
+ * type {@code T}, {@code T[]}, or {@code List<T>} where {@code T} is the type of the field or property. Parameters
  * of type {@code Sort}, {@code Order}, {@code Limit}, and {@code PageRequest} are prohibited.
  * </p>
  * <p>For example, consider an interface representing a garage:</p>

api/src/main/java/jakarta/data/repository/Find.java

@@ -34,8 +34,8 @@
  * </p>
  * <ul>
  * <li>have exactly the name (the parameter name in the Java source, or a name assigned by {@link By @By}) as a
- *     persistent field or property of the entity class and be of type {@code T}, {@code T[]}, or {@code Iterable<T>}
- *     where {@code T} is the type of the field or property, or</li>
+ *     persistent field or property of the entity class and be of type {@code T}, {@code T[]}, or {@code List<T>} where
+ *     {@code T} is the type of the field or property, or</li>
  * <li>be of type {@link jakarta.data.Limit}, {@link jakarta.data.Sort}, {@link jakarta.data.Order}, or
  *     {@link jakarta.data.page.PageRequest}.</li>
  * </ul>

spec/src/main/asciidoc/repository.asciidoc

@@ -831,7 +831,7 @@ Each automatic query method must be assigned an entity type. The rules for infer
 
 Jakarta Data infers a query based on the parameters of the method. Each parameter must either:
 
-- have exactly the same name as a persistent field or property of the entity class and be of type `T`, `T[]`, or `Iterable<T>` where `T` is the type of the field or property, or
+- have exactly the same name as a persistent field or property of the entity class and be of type `T`, `T[]`, or `List<T>` where `T` is the type of the field or property, or
 - be of type `Limit`, `Order`, `PageRequest`, or `Sort`.
 
 Parameter names map parameters to persistent fields. A repository with parameter-based automatic query methods must either: