From 655fd2e2bf2c37cb251102be8a4226f980084a44 Mon Sep 17 00:00:00 2001
From: Sam Brannen <104798+sbrannen@users.noreply.github.com>
Date: Sun, 15 Feb 2026 12:26:54 +0100
Subject: [PATCH] Document that SpEL expressions using Optional w/ null-safe &
 Elvis operators are not compilable

Closes gh-36331
---
 .../modules/ROOT/pages/core/expressions/evaluation.adoc          | 1 +
 1 file changed, 1 insertion(+)

diff --git a/framework-docs/modules/ROOT/pages/core/expressions/evaluation.adoc b/framework-docs/modules/ROOT/pages/core/expressions/evaluation.adoc
index 2501e72e4b3..137c0496f84 100644
--- a/framework-docs/modules/ROOT/pages/core/expressions/evaluation.adoc
+++ b/framework-docs/modules/ROOT/pages/core/expressions/evaluation.adoc
@@ -531,6 +531,7 @@ following kinds of expressions cannot be compiled.
 * Expressions relying on the conversion service
 * Expressions using custom resolvers
 * Expressions using overloaded operators
+* Expressions using `Optional` with the null-safe or Elvis operator
 * Expressions using array construction syntax
 * Expressions using selection or projection
 * Expressions using bean references