diff --git a/src/main/asciidoc/repositories.adoc b/src/main/asciidoc/repositories.adoc
index a92c1f3d1..2edeb8c6f 100644
--- a/src/main/asciidoc/repositories.adoc
+++ b/src/main/asciidoc/repositories.adoc
@@ -453,6 +453,8 @@ Sort sort = person.by(Person::getFirstname).ascending()
 ----
 ====
 
+NOTE: `TypedSort.by(…)` makes use of runtime proxies by typically using CGlib which may interfere with native image compilation when using tools like Graal VM Native.
+
 If your store implementation supports Querydsl, you can also use the metamodel types generated to define sort expressions:
 
 .Defining sort expressions using the Querydsl API