From 3f96fd021c531cdbbd17245323f77820f5443f30 Mon Sep 17 00:00:00 2001
From: Feng Jiajie <fengjiajie@sensorsdata.cn>
Date: Fri, 24 Oct 2025 11:31:53 +0800
Subject: [PATCH] Document kubernetes.podspec-dnsconfig feature flag

---
 .../serving/configuration/feature-flags.md    | 28 +++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/docs/versioned/serving/configuration/feature-flags.md b/docs/versioned/serving/configuration/feature-flags.md
index 70ad36a015..7b0a521440 100644
--- a/docs/versioned/serving/configuration/feature-flags.md
+++ b/docs/versioned/serving/configuration/feature-flags.md
@@ -523,6 +523,34 @@ spec:
 ...
 ```
 
+### Kubernetes DNS Config
+
+* **Type**: Extension
+* **ConfigMap key:** `kubernetes.podspec-dnsconfig`
+
+This flag controls whether a [`DNS config`](https://kubernetes.io/docs/concepts/services-networking/dns-pod-service/#pod-dns-config) can be specified.
+
+```yaml
+apiVersion: serving.knative.dev/v1
+kind: Service
+...
+spec:
+  template:
+    spec:
+      dnsPolicy: "None"
+      dnsConfig:
+        nameservers:
+          - 1.2.3.4
+        searches:
+          - ns1.svc.cluster-domain.example
+          - my.dns.search.suffix
+        options:
+          - name: ndots
+            value: "2"
+          - name: edns0
+...
+```
+
 ### Kubernetes Scheduler Name
 
 * **Type**: Extension