Merge pull request #44478 from dipesh-rawat/add-feature-gate-shortcode

Add shortcode to generate Feature gates tables

Author: k8s-ci-robot

content/en/docs/contribute/new-content/new-features.md

@@ -129,8 +129,28 @@ content is not received, the feature may be removed from the milestone.
 #### Feature gates {#ready-for-review-feature-gates}
 
 If your feature is an Alpha or Beta feature and is behind a feature gate,
-make sure you add it to [Alpha/Beta Feature gates](/docs/reference/command-line-tools-reference/feature-gates/#feature-gates-for-alpha-or-beta-features)
-table as part of your pull request. With net new feature gates, a separate
+you need a feature gate file for it inside
+`content/en/docs/reference/command-line-tools-reference/feature-gates/`.
+The name of the file should be the feature gate, converted from `UpperCamelCase`
+to `kebab-case`, with `.md` as the suffix.
+You can look at other files already in the same directory for a hint about what yours
+should look like. Usually a single paragraph is enough; for longer explanations,
+add documentation elsewhere and link to that.
+
+Also,
+to ensure your feature gate appears in the [Alpha/Beta Feature gates](/docs/reference/command-line-tools-reference/feature-gates/#feature-gates-for-alpha-or-beta-features) table, include the following details 
+in the [front matter](https://gohugo.io/content-management/front-matter/) of your Markdown
+description file:
+
+```yaml
+stages:
+  - stage: <alpha/beta/stable/deprecated>  # Specify the development stage of the feature gate
+    defaultValue: <true or false>     # Set to true if enabled by default, false otherwise
+    fromVersion: <Version>            # Version from which the feature gate is available
+    toVersion: <Version>              # (Optional) The version until which the feature gate is available
+```
+
+With net new feature gates, a separate
 description of the feature gate is also required; create a new Markdown file
 inside `content/en/docs/reference/command-line-tools-reference/feature-gates/`
 (use other files as a template).
@@ -147,14 +167,35 @@ feature gates). Watch out for language such as ”The `exampleSetting` field
 is a beta field and disabled by default. You can enable it by enabling the
 `ProcessExampleThings` feature gate.”
 
-If your feature is GA'ed or deprecated, make sure to move it from the
+If your feature is GA'ed or deprecated, 
+include an additional `stage` entry within the `stages` block in the description file. 
+Ensure that the Alpha and Beta stages remain intact. 
+This step transitions the feature gate from the 
 [Feature gates for Alpha/Feature](/docs/reference/command-line-tools-reference/feature-gates/#feature-gates-for-alpha-or-beta-features) table
-to [Feature gates for graduated or deprecated features](/docs/reference/command-line-tools-reference/feature-gates-removed/#feature-gates-that-are-removed)
-table with Alpha and Beta history intact.
-
-Eventually, Kubernetes will stop including the feature gate at all.
-In that case, you move it from [Feature gates for graduated or deprecated features](/docs/reference/command-line-tools-reference/feature-gates-removed/#feature-gates-that-are-removed)
-and into a separate page, [Feature Gates (removed)](/docs/reference/command-line-tools-reference/feature-gates-removed/).
+to [Feature gates for graduated or deprecated features](/docs/reference/command-line-tools-reference/feature-gates/#feature-gates-for-graduated-or-deprecated-features) table. For example:
+
+{{< highlight yaml "linenos=false,hl_lines=10-15" >}}
+stages:
+  - stage: alpha 
+    defaultValue: false
+    fromVersion: "1.12"
+    toVersion: "1.12"
+  - stage: beta 
+    defaultValue: true
+    fromVersion: "1.13"
+    toVersion: "1.18"    
+  # Added 'stable' stage block to existing stages.  
+  - stage: stable     
+    defaultValue: true
+    fromVersion: "1.19"
+    toVersion: "1.27"   
+{{< / highlight >}}
+
+Eventually, Kubernetes will stop including the feature gate at all. To signify the removal of a feature gate, 
+include `removed: true` in the front matter of the respective description file.
+This action triggers the transition of the feature gate 
+from [Feature gates for graduated or deprecated features](/docs/reference/command-line-tools-reference/feature-gates-removed/#feature-gates-that-are-removed) section to a dedicated page titled 
+[Feature Gates (removed)](/docs/reference/command-line-tools-reference/feature-gates-removed/).
 
 Also make sure to move the relevant list entry and
 [`feature-gate-description` shortcode](/docs/contribute/style/hugo-shortcodes/#feature-gate-description) into the

content/en/docs/reference/command-line-tools-reference/feature-gates-removed/index.md

@@ -6,6 +6,17 @@ content_type: feature_gate
 _build:
   list: never
   render: false
+
+stages:
+  - stage: alpha 
+    defaultValue: false
+    fromVersion: "1.6"
+    toVersion: "1.10"
+  - stage: deprecated
+    fromVersion: "1.11"
+    toVersion: "1.11"
+
+removed: true
 ---
 Provided an early form of plugin to enable Nvidia GPU support when using
 Docker Engine; no longer available. See

content/en/docs/reference/command-line-tools-reference/feature-gates/accelerators.md

@@ -4,6 +4,15 @@ content_type: feature_gate
 _build:
   list: never
   render: false
+
+stages:
+  - stage: alpha
+    defaultValue: false
+    fromVersion: "1.27"
+    toVersion: "1.27"
+  - stage: beta
+    defaultValue: true
+    fromVersion: "1.28"  
 ---
 Enable [match conditions](/docs/reference/access-authn-authz/extensible-admission-controllers/#matching-requests-matchconditions)
 on mutating & validating admission webhooks.

content/en/docs/reference/command-line-tools-reference/feature-gates/admission-webhook-match-conditions.md

@@ -4,5 +4,21 @@ content_type: feature_gate
 _build:
   list: never
   render: false
+
+stages:
+  - stage: alpha 
+    defaultValue: false
+    fromVersion: "1.7"
+    toVersion: "1.7"
+  - stage: beta 
+    defaultValue: true
+    fromVersion: "1.8"
+    toVersion: "1.11"    
+  - stage: stable
+    defaultValue: true
+    fromVersion: "1.12"
+    toVersion: "1.27"    
+
+removed: true  
 ---
 Enable [advanced auditing](/docs/tasks/debug/debug-cluster/audit/#advanced-audit)

content/en/docs/reference/command-line-tools-reference/feature-gates/advanced-auditing.md

@@ -6,6 +6,17 @@ content_type: feature_gate
 _build:
   list: never
   render: false
+
+stages:
+  - stage: alpha 
+    defaultValue: false
+    fromVersion: "1.6"
+    toVersion: "1.7"
+  - stage: deprecated
+    fromVersion: "1.8"
+    toVersion: "1.8"
+
+removed: true
 ---
 Enable setting
 [Pod affinity or anti-affinity](/docs/concepts/scheduling-eviction/assign-pod-node/#affinity-and-anti-affinity).

content/en/docs/reference/command-line-tools-reference/feature-gates/affinity-in-annotations.md

@@ -4,6 +4,15 @@ content_type: feature_gate
 _build:
   list: never
   render: false
+
+stages:
+  - stage: alpha
+    defaultValue: false
+    fromVersion: "1.26"
+    toVersion: "1.26"
+  - stage: beta
+    defaultValue: true
+    fromVersion: "1.27"
 ---
 Enable a single HTTP endpoint `/discovery/<version>` which
 supports native HTTP caching with ETags containing all APIResources known to the API server.

content/en/docs/reference/command-line-tools-reference/feature-gates/aggregated-discovery-endpoint.md

@@ -6,5 +6,17 @@ content_type: feature_gate
 _build:
   list: never
   render: false
+
+stages:
+  - stage: beta 
+    defaultValue: false
+    fromVersion: "1.4"
+    toVersion: "1.6"
+  - stage: stable
+    defaultValue: true
+    fromVersion: "1.7"
+    toVersion: "1.9"
+
+removed: true
 ---
 Enable a service to route external requests to node local endpoints.

content/en/docs/reference/command-line-tools-reference/feature-gates/allow-ext-traffic-local-endpoints.md

@@ -6,6 +6,18 @@ content_type: feature_gate
 _build:
   list: never
   render: false
+
+stages:
+  - stage: beta 
+    defaultValue: true
+    fromVersion: "1.17"
+    toVersion: "1.20"
+  - stage: stable
+    defaultValue: true
+    fromVersion: "1.21"
+    toVersion: "1.25"
+
+removed: true
 ---
 Enable the users to skip TLS verification of
 kubelets on Pod log requests.

content/en/docs/reference/command-line-tools-reference/feature-gates/allow-insecure-backend-proxy.md

@@ -4,5 +4,10 @@ content_type: feature_gate
 _build:
   list: never
   render: false
+
+stages:
+  - stage: deprecated
+    defaultValue: false
+    fromVersion: "1.29"    
 ---
 Enables `.status.ingress.loadBalancer` to be set on Services of types other than `LoadBalancer`.