diff --git a/CHANGELOG.md b/CHANGELOG.md
index e40838dc..57b1b93a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -11,6 +11,7 @@ All notable changes to this project will be documented in this file.
 - Support PodDisruptionBudgets for HistoryServer ([#288]).
 - Support for versions 3.4.1, 3.5.0 ([#291]).
 - History server now exports metrics via jmx exporter (port 18081) ([#291]).
+- Document graceful shutdown  ([#306]).
 
 ### Changed
 
@@ -43,6 +44,7 @@ All notable changes to this project will be documented in this file.
 [#291]: https://github.com/stackabletech/spark-k8s-operator/pull/291
 [#297]: https://github.com/stackabletech/spark-k8s-operator/pull/297
 [#302]: https://github.com/stackabletech/spark-k8s-operator/pull/302
+[#306]: https://github.com/stackabletech/spark-k8s-operator/pull/306
 
 ## [23.7.0] - 2023-07-14
 
diff --git a/docs/modules/spark-k8s/pages/usage-guide/operations/graceful-shutdown.adoc b/docs/modules/spark-k8s/pages/usage-guide/operations/graceful-shutdown.adoc
new file mode 100644
index 00000000..980e08aa
--- /dev/null
+++ b/docs/modules/spark-k8s/pages/usage-guide/operations/graceful-shutdown.adoc
@@ -0,0 +1,6 @@
+= Graceful shutdown
+
+Normally you can configure the graceful shutdown as described in xref:concepts:operations/graceful_shutdown.adoc[].
+
+However, the spark-k8s operator does not implement any graceful shutdown mechanism, as the driver and executor Pods are created by Spark itself.
+So it's Spark responsibility to handle the shutdown and recovery of Pods.
diff --git a/docs/modules/spark-k8s/partials/nav.adoc b/docs/modules/spark-k8s/partials/nav.adoc
index 8da19979..f3f55794 100644
--- a/docs/modules/spark-k8s/partials/nav.adoc
+++ b/docs/modules/spark-k8s/partials/nav.adoc
@@ -9,7 +9,8 @@
 ** xref:spark-k8s:usage-guide/s3.adoc[]
 ** xref:spark-k8s:usage-guide/history-server.adoc[]
 ** xref:spark-k8s:usage-guide/examples.adoc[]
-* xref:spark-k8s:usage-guide/operations/index.adoc[]
-* xref:spark-k8s:usage-guide/operations/pod-placement.adoc[]
-* xref:spark-k8s:usage-guide/operations/pod-disruptions.adoc[]
+** xref:spark-k8s:usage-guide/operations/index.adoc[]
+*** xref:spark-k8s:usage-guide/operations/pod-placement.adoc[]
+*** xref:spark-k8s:usage-guide/operations/pod-disruptions.adoc[]
+*** xref:spark-k8s:usage-guide/operations/graceful-shutdown.adoc[]
 * xref:spark-k8s:crd-reference.adoc[]