diff --git a/plugins/modules/k8s.py b/plugins/modules/k8s.py
index 7dd7a67b..4baefa14 100644
--- a/plugins/modules/k8s.py
+++ b/plugins/modules/k8s.py
@@ -221,6 +221,23 @@ EXAMPLES = r'''
   community.kubernetes.k8s:
     state: present
     src: ~/metrics-server.yaml
+
+# Wait for a Deployment to pause before continuing
+- name: Pause a Deployment.
+  community.kubernetes.k8s:
+    definition:
+      apiVersion: apps/v1
+      kind: Deployment
+      metadata:
+        name: example
+        namespace: testing
+      spec:
+        paused: True
+    wait: yes
+    wait_condition:
+      type: Progressing
+      status: Unknown
+      reason: DeploymentPaused
 '''
 
 RETURN = r'''