SLING-7194 Document that AdapterManager sorts AdapterFactory implementations lowest ranking first
diff --git a/src/main/java/org/apache/sling/api/adapter/AdapterFactory.java b/src/main/java/org/apache/sling/api/adapter/AdapterFactory.java
index 135cd00..01c2460 100644
--- a/src/main/java/org/apache/sling/api/adapter/AdapterFactory.java
+++ b/src/main/java/org/apache/sling/api/adapter/AdapterFactory.java
@@ -31,12 +31,19 @@
* used by the {@link AdapterManager} to adapt objects on demand. The
* <code>AdapterFactory</code> services are not really intended to be used by
* clients directly.
+ * </p>
* <p>
* The {@link AdapterManager} implementations ensures that the
* {@link #getAdapter(Object, Class)} method is only called for the combination
* of adaptable and adapter type which is allowed as per the service
* registration properties {@link #ADAPTABLE_CLASSES} and
* {@link #ADAPTER_CLASSES}.
+ * </p>
+ * <p>
+ * If multiple implementations for the same combination of adapter and adaptable
+ * are registered, the implementation with the lowest service ranking wins
+ * (or with the highest service id, if the ranking is the same).
+ * </p>
*/
@ConsumerType
public interface AdapterFactory {