diff --git a/docs/deploying.md b/docs/deploying.md
index 09fd3f3a0..01f593f51 100644
--- a/docs/deploying.md
+++ b/docs/deploying.md
@@ -481,6 +481,7 @@ OpenStackDataPlaneNodeSet has the following status fields:
 | DNSClusterAddresses | |
 | CtlplaneSearchDomain | |
 
+
 #### OpenStackDataPlaneDeployment Conditions and Status
 
 | Condition Type | Description |
@@ -504,6 +505,23 @@ OpenStackDataPlaneDeployment has the following status fields:
 | --- | --- |
 | Deployed | Boolean indicating successful deployment. All Services for all NodeSets have succeeded. |
 
+#### Dataplane deployment Pods
+
+Pods launched during deployement throught OpenStackAnsiblEEE managed jobs,
+further just pods, are are marked with label `osdpd=<OpenStackDataPlaneDeployment.Name>`
+and checked for failures.
+
+While the recovery of jobs is an automated process, additional information
+can be useful for diagnosing the issue.
+
+Failure of individual pods is logged on info level in format:
+
+ `"openstack dataplane pod <POD_NAME> failed due to <FAILURE_REASON> message: <FAILURE_MSG>"`
+
+Failed retrieval of pod statuses is logged as an error:
+
+`"unable to retrieve list of pods for dataplane diagnostic"`
+
 
 #### OpenStackDataPlaneService Conditions and Status