From e2110e0b8e8a38d93c387db9d0d67fb4fe577181 Mon Sep 17 00:00:00 2001
From: Robert Muir <rmuir@apache.org>
Date: Sat, 30 Mar 2024 09:51:31 -0400
Subject: [PATCH] Add regeneration workaround to the docs

---
 help/regeneration.txt | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/help/regeneration.txt b/help/regeneration.txt
index dc7ced3b988..440acbf096d 100644
--- a/help/regeneration.txt
+++ b/help/regeneration.txt
@@ -16,6 +16,22 @@ In many cases hitting (1) means you'll have to do (2) so let's discuss
 these in order.
 
 
+SPECIAL NOTE
+------------
+
+Regeneration tasks currently don't play well with the current gradle version.
+To workaround the issue, compile everything first:
+
+gradlew compileJava
+
+Then run the commands as described in this document, excluding compileJava.
+For example to run "regenerate":
+
+gradlew regenerate -x compileJava
+
+More information: https://github.com/apache/lucene/issues/13240
+
+
 Checksum validation errors
 --------------------------