diff --git a/releasenotes/notes/add-db-deadlock-handling-6bc10076537f3727.yaml b/releasenotes/notes/add-db-deadlock-handling-6bc10076537f3727.yaml
index d1536407a9..138b0cea4c 100644
--- a/releasenotes/notes/add-db-deadlock-handling-6bc10076537f3727.yaml
+++ b/releasenotes/notes/add-db-deadlock-handling-6bc10076537f3727.yaml
@@ -1,10 +1,12 @@
 ---
 fixes:
   - Fixes an issue which caused conductor's periodic tasks to stop executing.
-    See https://bugs.launchpad.net/ironic/+bug/1637210
+    See https://bugs.launchpad.net/ironic/+bug/1637210.
 features:
   - Adds DBDeadlock handling which may improve stability when using Galera.
-    See https://bugs.launchpad.net/ironic/+bug/1639338
+    See https://bugs.launchpad.net/ironic/+bug/1639338. Number of retries
+    depends on the configuration option ``[database]db_max_retries`` which
+    programmatically defaults to 5.
 upgrade:
   - All DB API methods doing database writes now retry on deadlock. The
     ``[database]db_max_retries`` configuration option specifies the maximum