From abe33703b42d9a5219a96c106093ed3c85509655 Mon Sep 17 00:00:00 2001
From: Sam Brannen <104798+sbrannen@users.noreply.github.com>
Date: Thu, 30 Jul 2026 15:16:19 +0300
Subject: [PATCH] Update Javadoc for
 PropertyDescriptorUtils.determineBasicProperties()

See gh-37081
---
 .../org/springframework/beans/PropertyDescriptorUtils.java  | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/spring-beans/src/main/java/org/springframework/beans/PropertyDescriptorUtils.java b/spring-beans/src/main/java/org/springframework/beans/PropertyDescriptorUtils.java
index 2bf6cb2dc1a..7bc37b37eb7 100644
--- a/spring-beans/src/main/java/org/springframework/beans/PropertyDescriptorUtils.java
+++ b/spring-beans/src/main/java/org/springframework/beans/PropertyDescriptorUtils.java
@@ -51,6 +51,12 @@ abstract class PropertyDescriptorUtils {
 	 * <p>This just supports the basic JavaBeans conventions, without indexed
 	 * properties or any customizers, and without other BeanInfo metadata.
 	 * For standard JavaBeans introspection, use the JavaBeans Introspector.
+	 * <p>Note that, in contrast to the standard {@link java.beans.Introspector},
+	 * this method does support a static {@code set} method as the write method
+	 * for a property, resulting in a write-only property if no corresponding
+	 * instance {@code get}/{@code is} method is present. Static {@code get} and
+	 * {@code is} methods, on the other hand, are never considered read methods
+	 * for a property, aligning with standard JavaBeans introspection.
 	 * @param beanClass the target class to introspect
 	 * @return a collection of property descriptors
 	 * @throws IntrospectionException from introspecting the given bean class