diff --git a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/spring-boot-features.adoc b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/spring-boot-features.adoc
index 22a2db7344..2114375ceb 100644
--- a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/spring-boot-features.adoc
+++ b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/spring-boot-features.adoc
@@ -3343,6 +3343,9 @@ To configure the timeout period, configure the configprop:spring.lifecycle.timeo
 spring.lifecycle.timeout-per-shutdown-phase=20s
 ----
 
+IMPORTANT: Using graceful shutdown with your IDE may not work properly if it does not send a proper `SIGTERM` signal.
+Refer to the documentation of your IDE for more details.
+
 
 
 [[boot-features-rsocket]]