From 98c4aa79bea1ececdbba20e810eadd4cf902b4b5 Mon Sep 17 00:00:00 2001
From: Stefan Bueringer <buringerst@vmware.com>
Date: Thu, 16 Oct 2025 17:12:39 +0200
Subject: [PATCH] Improve KAL config docs for forbidding OpenAPI defaulting
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Stefan Büringer buringerst@vmware.com
---
 .golangci-kal.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.golangci-kal.yml b/.golangci-kal.yml
index 852f7e54e8fc..3de3faca0924 100644
--- a/.golangci-kal.yml
+++ b/.golangci-kal.yml
@@ -55,6 +55,8 @@ linters:
                 description: "A field with a default value cannot be required"
             forbiddenmarkers:
               markers:
+                # We don't want to do any defaulting (including OpenAPI) anymore on API fields because we prefer
+                # to have a clear signal on user intent. This also allows us to easily change the default behavior if necessary.
                 - identifier: "kubebuilder:default"
                 - identifier: "default"
             conditions:
@@ -163,7 +165,6 @@ linters:
         - kubeapilinter
 
     # Excludes for existing default markers 
-    # We don't want to use OpenAPI defaulting anymore.
     - path: "api/core/v1beta2/clusterclass_types.go"
       text: 'forbiddenmarkers: field Reason has forbidden marker "kubebuilder:default=FieldValueInvalid"'
       linters: