From 670eb0478f58db5b335b1af1e5aada1bc44eccc8 Mon Sep 17 00:00:00 2001
From: Varnika Sinha <varnsinha@gmail.com>
Date: Wed, 8 Oct 2025 17:47:02 -0400
Subject: [PATCH] kubectl-{diff, patch}: add page (#18414)

Signed-off-by: varnika <varnika@ibm.com>
---
 pages/common/kubectl-diff.md  |  8 ++++++++
 pages/common/kubectl-patch.md | 20 ++++++++++++++++++++
 2 files changed, 28 insertions(+)
 create mode 100644 pages/common/kubectl-diff.md
 create mode 100644 pages/common/kubectl-patch.md

diff --git a/pages/common/kubectl-diff.md b/pages/common/kubectl-diff.md
new file mode 100644
index 0000000000..dc0472ac3d
--- /dev/null
+++ b/pages/common/kubectl-diff.md
@@ -0,0 +1,8 @@
+# kubectl diff
+
+> Check differences between live resources and files.
+> More information: <https://kubernetes.io/docs/reference/kubectl/generated/kubectl_diff>.
+
+- View differences between the live resource and file definition:
+
+`kubectl diff {{[-f|--filename]}} {{path/to/filename}}`
diff --git a/pages/common/kubectl-patch.md b/pages/common/kubectl-patch.md
new file mode 100644
index 0000000000..b2776ef733
--- /dev/null
+++ b/pages/common/kubectl-patch.md
@@ -0,0 +1,20 @@
+# kubectl patch
+
+> Patch Kubernetes resources with new values.
+> More information: <https://kubernetes.io/docs/reference/kubectl/generated/kubectl_patch>.
+
+- Partially patch a secret using a strategic merge JSON patch to remove the finalizer:
+
+`kubectl patch secrets {{secret_name}} {{[-p|--patch]}} '{"metadata":{"finalizers": []\}\}' --type merge`
+
+- Partially patch a secret using a strategic merge YAML patch to remove the finalizer:
+
+`kubectl patch secrets {{secret_name}} {{[-p|--patch]}} $'metadata:\n finalizers: []' --type merge`
+
+- Partially patch a pod's container using a JSON patch with positional arrays:
+
+`kubectl patch {{[po|pods]}} {{pod_name}} --type 'json' {{[-p|--patch]}} '[{"op": "replace", "path": "/spec/containers/0/image", "value":"{{new_image_value}}"}]'`
+
+- Update a deployment's replicas through the scale subresource using a strategic merge JSON patch:
+
+`kubectl patch {{[deploy|deployments]}} {{deployment_name}} --subresource 'scale' --type 'merge' {{[-p|--patch]}} '{"spec":{"replicas":{{number_of_replicas}}\}\}'`